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内 容 简 介 

本 书 是 一 本 Python Web 的 技术 总 结 ， 主 要 以 Python 3 和 Django 2.0 版 本 实现 。 通 过 本 书 的 学 习 ， 读 
者 能 够 透彻 掌握 Django 2.0 各 个 功能 模块 的 使 用 以 及 实现 方式 ， 并 以 音乐 平台 开发 为 例 ， 让 读者 快速 
掌握 Django 2.0 开 发 应 用 的 实用 技能 。 此 外 ， 本 书 还 介绍 了 Diango 项 目的 上 线 以 及 通过 第 三 方 功能 模 
块 和 框架 实现 网 站 的 API 开 发 、 网 站 验证 码 、 站 内 搜索 引擎 、 第 三 方 网 站 用 户 注册 以 及 网 站 的 分 布 式 
任务 和 定时 任务 。 

本 书 实用 性 强 、 案 例 丰 富 、 与 新 技术 紧密 联系 ， 适 合 有 一 定 Python 基础 的 读者 和 转型 到 Python 的 
开发 人 员 使 用 ， 也 可 用 作 培 训 机 构 和 大 中 专 院 校 的 参考 教材 。 
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Python 是 当前 热门 的 开发 语言 之 一 , 它 有 着 广泛 的 应 用 领域 , 在 网 络 扑 虫 、Web 开发 、 
数据 分 析 和 人 工 智能 等 领域 都 受到 开发 者 的 热爱 和 追捧 。 现 在 很 多 企业 开始 使 用 Python 
作为 网 站 服务 器 的 开发 语言 ， 因 此 掌握 Web 开发 是 Python 开发 者 必 不 可 少 的 技能 之 一 。 

Django 是 Python 开发 网 站 的 首选 Web 框架 ， 这 归功 于 Django 较 强 的 规范 性 ， 规 范 
了 开发 人 员 的 编码 要 求 ， 以 符合 企业 的 规范 化 管理 。 正 因 如 此 ，Django 成 为 开发 人 员 必 
学 的 Web 框架 之 一 。 

本 书 讲述 的 内 容 基 于 Django 2.0 或 以 上 版 本 ， 详 细 剖 析 Django 的 功能 要 点 ， 让 读者 
全 面 了 解 Django， 并 通过 实例 演示 进一步 加 深 对 知识 点 的 掌握 和 理解 。 


本 书 结构 


本 书 共 分 13 章 ， 各 章 内 容 概述 如 下 : 

第 1 章 介 绍 网 站 的 基础 知识 和 Django 的 环境 搭建 ， 分 别 讲述 了 网 站 的 定义 、 分 类 、 
运行 原理 、Django 的 安装 使 用 和 开发 环境 的 搭建 。 

第 2 章 介绍 Django 的 项 目 配置 ， 包 括 基 本 配置 、 静 态 资 源 、 模 板 路 径 、 数 据 库 配置 
和 中 间 件 。 

第 3 章 讲 述 三 种 URL 的 编写 规则 ， 包 括 常 规 的 URL、 带 变量 的 URL 和 带 参数 的 
URL 的 编写 规则 。 

第 4 章 介 绍 视图 的 编写 方法 ， 在 视图 中 讲述 用 户 请 求 方式 的 获取 、 模 板 数据 的 传递 
和 通用 视图 的 使 用 。 

第 5 章 讲述 模板 的 编写 方法 , 包括 模板 的 变量 \ 标 签 、 模 板 继 承 和 过 滤器 的 定义 与 使 用 。 

第 6 章 介绍 模型 的 定义 与 使 用 ， 讲 述 模型 与 数据 表 的 映射 关系 ， 通 过 模型 对 象 的 操 
作 实 现 数据 表 的 读 写 。 

第 7 章 介绍 表单 的 定义 与 使 用 ， 主 要 讲述 表单 与 模型 的 结合 生成 数据 表单 ， 并 通过 
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数据 表单 操作 实现 数据 表 的 数据 读 写 。 

第 8 章 介绍 Django 内 置 的 Admin 后 台 ， 主 要 讲述 Admin 的 基本 设置 以 及 一 些 常 
用 功能 的 二 次 开发 。 

第 9 章 介 绍 Django 内 置 的 Auth 认证 系统 ， 讲 述 内 置 模 型 User 的 使 用 和 扩展 ， 
实现 用 户 注册 和 登录 功能 、 用 户 权 限 的 设置 和 用 户 组 的 设置 。 

第 10 章 介绍 Django 常用 的 内 置 功能 ， 包 括 会 话 Session、 缓 存 机 制 、CSRF 防护 、 
消息 提示 和 分 页 功能 。 

第 11 章 讲 述 音乐 网 站 的 开发 , 网 站 主要 功能 有 首页 、 排 行 榜 、 歌 曲 播放 、 歌 曲 点 评 、 
歌曲 搜索 、 用 户 注册 和 登录 、 用 户 中心 、Admin 后 台 管 理 和 网 站 异常 机 制 。 

第 12 章 讲述 Django 项 目的 上 线 部 署 ， 以 虚拟 机 CentOS 7 系统 为 例 ， 讲 解 
Python、uWSGI 和 Nginx 的 安装 和 部 署 。 

第 13 章 介绍 Django 的 第 三 方 应 用 ， 通 过 第 三 方 提供 的 功能 模块 和 框架 实现 网 站 
的 API 开 发 、 网 站 验证 码 、 站 内 搜索 引擎 、 第 三 方 网 站 用 户 注册 以 及 网 站 的 分 布 式 任 
务 和 定时 任务 。 


本 书 特色 


循序 渐进 ， 知 识 全 面 : 本 书 站 在 初学 者 的 角度 ， 围 绕 Python 的 Django 框架 展开 
讲解 ， 从 初学 者 必 备 基础 知识 着 手 ， 循 序 渐进 地 介绍 了 Diango 的 各 种 知识 ， 内 容 难 
度 适中 ， 由 浅 入 深 ， 实 用 性 强 ， 和 覆盖 面 广 ， 条 理 清晰 ， 且 具有 较 强 的 逻辑 性 和 系统 性 。 

实例 丰富 ， 扩 展 性 强 ， 本 书 每 个 知识 点 都 是 单独 以 一 个 项 目 为 例 进 行 讲解 的 ， 力 
求 让 读者 更 容易 地 掌握 知识 要 点 。 本 书 实例 经 过 作者 的 精心 设计 和 挑选 ， 根 据 编者 的 
实际 开发 经 验 总 结 而 来 ， 涵 盖 在 实际 开发 中 遇 到 的 各 种 问题 。 

基于 理论 ， 注 重 实践 : 在 讲解 的 过 程 中 ， 不 仅 介绍 理论 知识 ， 而 且 安 排 了 综合 应 
用 实例 或 小 型 应 用 程序 ， 将 理论 应 用 到 实践 中 ， 加 强 读者 的 实际 开发 能 力 ， 巩 固 开发 
技能 和 相关 知识 


源 代码 下 载 


本 书 的 实例 源 代码 可 以 在 百度 网 盘 下 载 ， 提 取 密 码 slzw， 也 可 以 在 清华 大 学 出 
版 社 文 泉 云 盘 下 载 ， 二 维 码 分 别 如 下 : 


理 
ID 








如 果 你 在 下 载 过 程 中 遇 到 问题 ， 可 发 送 邮件 至 554301449@qq.com 获得 帮助 ， 邮 
件 标题 为 “ 玩 转 Python Django 下 载 资源 ”。 

读者 还 可 以 关注 编者 在 CSDN 上 的 视频 课程 ， 课 程 网 址 : https://edu.csdn.net/ 
course/detall/9280。 





技术 服务 


读者 在 学 习 或 开发 的 过 程 中 ， 如 果 遇 到 实际 问题 ， 可 以 加 入 QQ 群 783234662 与 
笔者 联系 ， 笔 者 会 在 第 一 时 间 给 予 回 复 。 








读者 对 象 
本 书 主要 适合 以 下 读者 阅读 : 
e Django 初学 者 及 在 校 学 生 。 
。 Django 初级 开发 工程 师 。 
。 ”从事 Python 网 站 开发 的 技术 人 员 。 
。 其 他 学 习 Django 的 开发 人 员 。 





虽然 笔者 力求 本 书 更 雄 完美 ,但 由 于 水 平 所 限 ， 难 免 会 出 现 错误 ， 特 别 是 Django 
版 本 更 新 可 能 导致 源 代 码 在 运行 过 程 中 出 现 问题 ， 欢 迎 广大 读者 和 专家 给 予 指正 ， 笔 
者 将 十 分 感谢 。 
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D jango 建站 基础 


一 个 完整 的 网 站 大 概 包含 域名 、 网 站 应 用 和 服务 器 。 域 名 可 理解 为 网 站 的 链接 ; 
网 站 应 用 是 指 这 个 网 站 有 哪些 页 面 ， 这 些 页 面 有 什么 功能 并 且 如 何 实现 这 些 功能 ， 这 
也 是 本 书 主要 讲述 的 内 容 ， 服 务 器 是 连接 到 互联 网 的 计算 机 ， 用 于 网 站 应 用 的 部 署 和 
上 线 。 


1.1 网 站 的 定义 及 组 成 


网 站 〈Website) 是 指 在 因特网 上 根据 一 定 的 规则 ， 使 用 HIML (标准 通用 标记 
语言 下 的 一 个 应 用 ) 等 工具 制作 并 用 于 展示 特定 内 容 相 关 网 页 的 集合 。 简 单 地 说 ， 网 
站 是 一 种 沟通 工具 ， 人 们 可 以 通过 网 站 来 发 布 自己 想 要 公开 的 资讯 ， 或 者 利用 网 站 来 
提供 相关 的 网 络 服务 ， 也 可 以 通过 网 页 浏览 器 来 访问 网 站 ， 获 取 自 己 需 要 的 资讯 或 者 
享受 网 络 服务 。 
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在 早期 ， 域 名 、 空 间 服务 器 与 程序 是 网 站 的 基本 组 成 部 分 ， 随 着 科技 的 不 断 进步 ， 
网 站 的 组 成 也 日 趋 复杂 ， 目 前 多 数 网 站 由 域名 、 空 间 服务 器 、DNS 域名 解析 、 网 站 程 
序 和 数据 库 等 组 成 。 

域名 (Domain Name) 由 一 串 用 点 分 隔 的 字母 组 成 ， 代 表 互 联网 上 某 一 台 计 算 机 
或 计算 机 组 的 名 称 ， 用 于 在 数据 传输 时 标识 计算 机 的 电子 方位 ， 已 经 成 为 互联 网 的 品 
牌 和 网 上 商标 保护 必 备 的 产品 之 一 。 通 俗 地 说 ， 域 名 就 相当 于 一 个 家 庭 的 门牌 号 码 ， 
别人 通过 这 个 号 码 可 以 很 容易 地 找到 你 所 在 的 位 置 。 以 百度 的 域名 为 例 ， 百 度 的 网 址 
是 由 两 部 分 组 成 的 ， 标 号 “baidu” 是 这 个 域名 的 主 域名 体 ; 前面 的 www. 是 网 络 名 ; 
最 后 的 标号 “com” 则 是 该 域名 的 后 级 ， 代 表 是 一 个 国际 域名 ， 属 于 顶级 域名 之 一 。 

常见 的 域名 后 级 有 以 下 几 种 。 


e。 .COM: 商业 性 的 机 构 或 公司 。 

。 .NET: 从 事 Internet 相关 的 网 络 服务 的 机 构 或 公司 。 

。 .ORG: 非 营利 的 组 织 、 团 体 。 

e。 .GOV: 政府 部 门 。 

。 .CN: 中 国 国内 域名 。 

。 .COM.CN: 中 国 商业 域名 。 

。 .NET.CN: 中 国 从 事 Intemet 相关 的 网 络 服务 的 机 构 或 公司 。 
。 .ORG.CN: 中 国 非 营利 的 组 织 、 团 体 。 

。 .GOV.CN: 中 国政 府 部 门 。 


空间 服务 器 主要 有 虚拟 主机 、 独 立 服务 器 和 VPS。 

虚拟 主机 是 在 网 络 服务 器 上 划分 出 一 定 的 磁盘 空间 供用 户 放 置 站 点 和 应 用 组 件 
等 ， 提 供 必 要 的 站 点 功能 、 数 据 存 放 和 传输 功能 。 所 谓 虚 拟 主机 ， 也 叫 “ 网 站 空间 ”， 
就 是 把 一 台 运 行 在 互联 网 上 的 服务 器 划分 成 多 个 “虚拟 ”的 服务 器 。 每 一 个 虚拟 主机 
都 具有 独立 的 域名 和 完整 的 Intemet 服务 器 (支持 WWW、FIP、E-mail 等 ) 功能 。 
虚拟 主机 是 网 络 发 展 的 福音 ， 极 大 地 促进 了 网 络 技术 的 应 用 和 普及 。 同 时 虚拟 主机 的 
租用 服务 也 成 了 网 络 时 代 新 的 经 济 形 式 ， 虚 拟 主机 的 租用 类 似 于 房屋 租用 。 

独立 服务 器 是 指 性 能 更 强大 、 整体 硬件 完全 独立 的 服务 器 , 其 CPU 都 在 8 核 以 上 。 

VPS 即 虚 拟 专用 服务 器 , 是 将 一 个 服务 器 分 区 成 多 个 虚拟 独立 专 享 服务 器 的 技术 。 


第 1 章 ”Django 建站 基础 


每 个 使 用 VPS 技术 的 虚拟 独立 服务 器 拥有 各 自 独 立 的 公 网 卫 地 址 、 操 作 系统 、 硬 盘 
空间 、 内 存 空 间 和 CPU 资源 等 ， 还 可 以 进行 安装 程序 、 重 启 服务 器 等 操作 ， 与 一 台 
独立 服务 器 完全 相同 。 

网 站 程序 是 建设 与 修改 网 站 所 使 用 的 编程 语言 ， 源 代码 是 按 一 定格 式 书写 的 文字 
和 符号 编写 的 ， 可 以 是 任何 编程 语言 。 常 见 的 网 站 开发 语言 有 Java、PHP、ASPNET 
和 Python。 而 浏览 器 就 如 程序 的 编译 器 ， 它 会 将 源 代 码 翻译 成 图 文 内容 呈 现在 网 页 上 。 


1.2 网 站 的 分 类 


资讯 门户 类 网 站 以 提供 信息 资讯 为 主要 目的 ， 是 目前 普遍 的 网 站 形式 之 一 ， 例 如 
新 浪 、 搜 狐 和 新 华 网 。 这 类 网 站 虽然 涵盖 的 信息 类 型 多 、 信 息 量 大 和 访问 群体 广 ， 但 
包含 的 功能 却 比 较 简单 ， 网 站 基本 功能 包含 检索 、 论 坛 、 留 言 和 用 户 中 心 等。 

这 类 网 站 开发 的 技术 含量 主要 涉及 4 个 因素 : 





e “承载 的 信息 类 型 。 例 如 是 否 承 载 多 媒体 信息 、 是 否 承载 结构 化 信息 等 。 
”信息 发 布 的 方式 和 流程 。 

e ”信息 量 的 数量 级 。 

。 网 站 用 户 管理 。 


企业 品牌 类 网 站 用 于 展示 企业 综合 实力 ， 体 现 企 业 文化 和 品牌 理念 。 企 业 品牌 网 
站 非常 强调 创意 ， 对 于 美工 设计 要 求 较 高 ， 精 美的 FLASH 动画 是 常用 的 表现 形式 。 
网 站 内 容 组 织 策划 和 产品 展示 体验 方面 也 有 较 高 要 求 。 网 站 利用 多 媒体 交互 和 动态 网 
页 技术 ， 针 对 目标 客户 进行 内 容 建 设 ， 达 到 品牌 营销 传播 的 目的 。 
企业 品牌 网 站 可 细 分 为 以 下 三 类 。 
。 企业 形象 网 站 : 塑造 企业 形象 、 传 播 企 业 文化 、 推 介 企 业 业 务 、 报 道 企 业 活 
动 和 展示 企业 实力 。 
e ”品牌 形象 网 站 : 当 企 业 拥 有 众多 品牌 且 不 同 品牌 之 间 市 场 定位 和 营销 策略 各 
不 相同 时 ， 企 业 可 根据 不 同 品牌 建立 其 品牌 网 站 ， 以 针对 不 同 的 消费 群体 。 
日” 产品 形象 网 站 : 针对 某 一 产品 的 网 站 ， 重 点 在 于 产品 的 体验 。 
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交易 类 网 站 以 实现 交易 为 目的 ,以 订单 为 中 心 。 交易 的 对 象 可 以 是 企业 和 消费 者 。 
这 类 网 站 有 三 项 基本 内 容 : 商品 如 何 展示 、 订 单 如 何 生成 和 订单 如 何 执行 。 

因此 , 这 类 网 站 一 般 需要 有 产品 管理 、 订购 管理 、 订单 管理 、 产品 推荐 、 支付 管理 、 
收费 管理 、 送 发 货 管理 和 会 员 管理 等 基本 功能 。 功 能 复杂 一 点 的 可 能 还 需要 积分 管理 
系统 、VIP 管理 系统 、CRM 系统 、MIS 系统 、ERP 系统 和 商品 销售 分 析 系 统 等 。 交 
易 类 网 站 成 功 与 否 的 关键 在 于 业务 模型 的 优 务 。 交 易 类 网 站 可 细 分 为 以 下 三 大 类 型 。 





eB2C (Business To Consumer) 网 站 : 商家 消费 者 ， 主 要 是 购物 网 站 ， 用 
于 商家 和 消费 者 之 间 的 买卖 ， 如 传统 的 百货 商店 和 购物 广场 等 。 

。 B2B (Business To Business) 网 站 : 商家 一 一 商家 ， 主 要 是 商务 网 站 ， 用 于 商 
家 之 间 的 买卖 ， 如 传统 的 原材料 市 场 和 大 型 批发 市 场 。 

ee C2C (Consumer To Consumer) 网 站 : 消费 者 一 一 消费 者 ， 主 要 以 拍卖 网 站 为 
主 ， 用 于 个 人 物品 的 买卖 ， 如 传统 的 旧 货 市 场 、 跳 隙 市 场 、 废 品 收购 站 等 。 


办 公 及 政府 机 构 网 站 分 为 企业 办 公事 务 类 网 站 和 政府 办 公 类 网 站 。 企 业 办 公事 
务 类 网 站 主要 包括 企业 办 公事 务 管理 系统 、 人 力 资源 管理 系统 和 办 公 成 本 管理 系统 。 

政府 办 公 类 网 站 是 利用 政府 专用 网 络 和 内 部 办 公 网 络 而 建立 的 内 部 门户 信息 网 ， 
是 为 了 方便 办 公 区 域 以 外 的 相关 部 门 互通 信息 、 统 一 数据 处 理 和 共享 文件 资料 而 建立 
的 ， 其 基本 功能 有 : 

(1) 提供 多 数据 源 接口 ， 实 现 业务 系统 的 数据 整合 。 

(2) 统一 用 户 管理 ， 提 供 方便 有 效 的 访问 权限 和 管理 权限 体系 。 

(3) 灵活 设立 子 网 站 ， 实 现 复杂 的 信息 发 布 管理 流程 。 

网 站 面向 社会 公众 ， 既 可 提供 办 事 指 南 、 政 策 法 规 和 动态 信息 等 ， 也 可 提供 网 
上 行政 业务 申报 、 办 理 和 相关 数据 查询 等 。 

互动 游戏 网 站 是 近年 来 国内 逐渐 风靡 起 来 的 一 种 网 站 。 这 类 网 站 的 投入 是 根据 
所 承载 游戏 的 复杂 程度 来 定 的 ， 其 发 展 趋势 是 向 超 巨 型 方向 发 展 ， 有 的 已 经 形成 了 独 
立 的 网 络 世界 。 

功能 性 网 站 是 一 种 新 型 网 站 ， 其 中 Google 和 百度 是 典型 代表 。 这 类 网 站 的 主要 
特征 是 将 一 个 具有 广泛 需求 的 功能 扩展 开 来 ， 开 发 一 套 强 大 的 功能 体系 ， 将 功能 的 实 
现 推 向 极致 。 功 能 在 网 页 上 看 似 简单 , 但 实际 投入 成 本 相当 惊人 , 而 且 效 益 也 非常 巨大 。 
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1.3 网 站 运行 原理 及 开发 流程 


如 果 刚 接触 网 站 开发 , 很 有 必要 了 解 网 站 的 运行 原理 。 在 了 解 网 站 运行 原理 之 前 ， 
首先 需要 理解 网 站 中 一 些 常 用 的 术语 。 

客户 端 : 在 计算 机 上 运行 并 连接 到 互联 网 的 应 用 程序 ， 简 称 浏览 器 ， 如 
Chrome、Firefox 和 正 。 用 户 通过 操作 客户 端 实现 网 站 和 用 户 之 间 的 数据 交互 。 

服务 器 : 能 连接 到 互联 网 且 具 有 了 他 地址 的 计算 机 ， 服 务 器 主要 接收 和 处 理 用 户 
的 请 求 信息 。 当 用 户 在 客户 端 操作 网 页 的 时 候 ， 实 质 是 向 网 站 发 送 一 个 HTTP 请 求 ， 
网 站 的 服务 器 接收 到 请 求 后 会 执行 相应 的 处 理 ， 最 后 将 处 理 结果 返回 到 客户 端 并 生成 
相应 的 网 页 信息 。 

卫 地 址 : 互联 网 协议 地 址 , TCP/IP 网 络 设备 (计算 机 、 服 务 器 、 打 印 机 、 路 由 器 等 ) 
的 数字 标识 符 。 互 联网 上 的 每 台 计算 机 都 有 一 个 了 P 地 址 ， 用 于 识别 和 通信 。 了 JP 地 址 
有 4 组 数字 ， 以 小 数 点 分 隔 〈 例 如 244.155.65.2) ， 这 被 称 为 逻辑 地 址 。 为 了 在 网 络 
中 定位 设备 ， 通 过 TCP/IP 协议 将 逻辑 人 P 地 址 转换 为 物理 地 址 〈 物 理 地 址 即 计算 机 里 
面 的 MAC 地 址 ) 。 

域名 : 用 于 标识 一 个 或 多 个 他 地址 。 

DNS: 域名 系统 ， 用 于 跟踪 计算 机 的 域名 及 其 在 互联 网 上 相应 的 他 地址 。 

ISP: 互联 网 服务 提供 商 。 主 要 工作 是 在 DNS (域名 系统 ) 查找 当前 域名 对 应 的 
IP 地 址 。 

TCP/IP: 传输 控制 协议 / 互联 网 协议 ， 是 广泛 使 用 的 通信 协议 。 

HTTP: 超 文本 传输 协议 ， 是 浏览 器 和 服务 器 通过 互联 网 进行 通信 的 协议 。 

了 解 网 站 常用 术语 后 ， 我 们 通过 一 个 简单 的 例子 来 讲解 网 站 运行 的 原理 。 





(1) 在 浏览 器 中 输入 网 站 地 址 ， 如 www.github.com。 

(2) 浏览 器 解析 网 站 地 址 中 包含 的 信息 ， 如 HITP 协议 和 域名 〈github.com) 。 

(3) 浏览 器 与 ISP 通信 ， 在 DNS 查找 www.github.com 所 对 应 的 他 地 址 ， 然 后 
将 他 地 址 发 送 到 浏览 器 的 DNS 服务 ， 最 后 向 www.github.com 的 IP 地 址 发 送 请 求 。 


(4) 浏览 器 从 网 站 地 址 中 获取 下 地 址 和 端口 (HTTP 协议 默认 为 端口 80， 
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HTTPS 默认 为 端口 443), 并 打开 TCP 套 接 字 连 接 , 实现 浏览 器 和 Web 服务 器 的 连接 。 
(5) 浏览 器 根据 用 户 操作 向 服务 器 发 送 相应 的 HITP 请 求 ， 如 打开 www.github. 
com 的 主页 面 。 
(6) 当 Web 服 务 器 接收 请 求 后 , 根据 请 求 信息 查找 该 HTML 页 面 。 如 果 页 面 存在 ， 
则 Web 服务 器 将 处 理 结果 和 页 面 返回 到 浏览 器 。 如 果 服 务 器 找 不 到 页 面 ， 将 发 送 一 
个 404 错误 消息 ， 代 表 找 不 到 相关 的 页 面 。 


很 多 人 认为 网 站 开发 是 一 件 很 困难 的 事情 ， 其 实 没有 想象 中 那么 困难 。 只 要 明 
白 了 网 站 的 开发 流程 ， 就 会 觉得 网 站 开发 是 非常 简单 的 。 如 果 没 有 一 个 清晰 的 开发 流 
程 指导 开发 ， 那 么 整个 开发 过 程 中 就 会 觉得 难以 实行 。 完 整 的 开发 流程 如 下 。 


(1) 需求 分 析 : 当 拿 到 一 个 项 目 时 ， 必 须 进 行 需求 分 析 ， 清 楚 知道 网 站 的 类 型 、 
具体 功能 、 业 务 逻 辑 以 及 网 站 的 风格 ， 此 外 还 要 确定 域名 、 网 站 空间 或 者 服务 器 以 及 
网 站 备案 等 。 

(2) 规划 静态 内 容 : 重新 确定 需求 分 析 ， 并 根据 用 户 需 求 规划 出 网 站 的 内 容 板 
块 草图 。 

(3) 设计 阶段 : 根据 网 站 草图 ， 由 美工 制作 成 效果 图 。 就 好 比 建 房子 一 样 ， 首 
先 画 出 效果 图 ， 然 后 才 开始 建 房子 ， 网 站 开发 也 是 如 此 。 

(4) 程序 开发 阶段 : 根据 草图 划分 页 面 结构 和 设计 ， 前 端 和 后 台 可 以 同时 进行 。 
前 端 根据 美工 效果 负责 制作 静态 页 面 ， 后 台 根 据 页面 结 构 和 设计 ， 设 计数 据 库 数 据 结 
构 和 开发 网 站 后 台 。 

(5) 测试 和 上 线 : 在 本 地 搭建 服务 器 ， 测 试 网 站 是 否 存在 BUG。 若 无 问题 ， 则 
可 以 将 网 站 打包 ， 使 用 FTP 上 传 至 网 站 空间 或 者 服务 器 。 

(6) 维护 推广 : 在 网 站 上 线 之 后 ， 根 据 实 际 情况 完善 网 站 的 不 足 ， 定 期 修复 和 
升级 ， 保 障 网 站 运营 顺畅 ， 然 后 对 网 站 进行 推广 宣传 等 。 


1.4 走 进 Django 





Django 是 一 个 开放 源 代码 的 Web 应 用 框架 ， 由 Python 写成 ， 最 初 用 于 管理 劳 伦 
斯 出 版 集团 旗下 的 一 些 以 新 闻 内 容 为 主 的 网 站 ， 即 CMS〈 内容 管理 系统 ) 软件 ， 于 
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2005 年 7 月 在 BSD 许可 证 下 发 布 ， 这 套 框架 是 以 比利时 的 吉卜赛 酉 士 吉 他 手 Django 
Reinhardt 来 命名 的 .Django 采 用 了 MTV 的 框架 模式 , 即 模型 (Model)、 模 板 (Template) 
和 视图 (Views) ， 三 者 之 间 各 自负 责 不 同 的 职责 。 


。 模型 ， 数 据 存 取 层 ， 处 理 与 数据 相关 的 所 有 事务 ， 例 如 如 何 存 取 、 如 何 验证 
有 效 性 、 包 含 哪些 行为 以 及 数据 之 间 的 关系 等 。 

。 视图 ， 表现 层 ， 处 理 与 表现 相关 的 决定 ， 例 如 如 何在 页 面 或 其 他 类 型 文档 中 
进行 显示 。 

e。 模板 , 业务 逻辑 层 , 存 取 模型 及 调 取 恰 当 模板 的 相关 逻辑 , 模型 与 模板 的 桥梁 。 


Django 的 主要 目的 是 简便 、 快 速 地 开发 数据 库 驱 动 的 网 站 。 它 强调 代码 复 用 ， 
多 个 组 件 可 以 很 方便 地 以 插件 形式 服务 于 整个 框架 ，Django 有 许多 功能 强大 的 第 三 
方 插件 ， 可 以 很 方便 地 开发 出 自己 的 工具 包 。 这 使 得 Django 具有 很 强 的 可 扩展 性 ， 
还 强调 快速 开发 和 DRY (Do Not Repeat Yourself) 原则 。Django 基于 MVC 的 设计 十 
分 优美 : 


e 对象 关 系 映射 (Object Relational Mapping，ORM) : 通过 定义 映射 类 来 构建 
数据 模型 ， 将 模型 与 关系 数据 库 连 接 起 来 ， 使 用 ORM 框架 内 置 的 数据 库 接 
口 可 实现 复杂 的 数据 操作 。 

URL 设计 : 开发 者 可 以 设计 任意 的 URL (网 站 地 址 ) ， 而 且 还 支持 使 用 正则 
表达 式 设计 。 

e。 ”模板 系统 :提供 可 扩展 的 模板 语言 ， 模 板 之 间 具 有 可 继承 性 。 

表单 处 理 : 可 以 生成 各 种 表单 模型 ， 而 且 表单 具有 有 效 性 检验 功能 。 

e Cache 系统 : 完善 的 缓存 系统 ， 可 支持 多 种 缓存 方式 。 

e@ “用户 管理 系统 : 提供 用 户 认 证 、 权 限 设 置 和 用 户 组 功能 ， 功 能 扩展 性 强 。 

e 国际 化 : 内 置 国际 化 系统 ， 方 便 开发 出 多 种 语言 的 网 站 。 

e admin 管理 系统 : 内 置 admin 管理 系统 ， 系 统 扩展 性 强 。 


1.5 Django 2.0 的 新 特性 


2017 年 12 月 2 日 ，Django 官方 发 布 了 2.0 版 本 ， 成 为 多 年 来 第 一 次 大 版 本 提升 。 
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其 中 最 主要 的 特性 是 Django 2.0 支持 Python 3.4、3.5 和 3.6， 不 再 支持 Python 2， 而 
Django 1.11 是 支持 Python 2.7 的 最 后 版 本 。 此 外 ， 新 版 本 还 有 以 下 显著 的 新 特性 。 


简化 URL 路 由 语法 : 使 得 Django.urls.path() 方法 的 语法 更 简单 。 功 能 的 导入 
由 模块 Django.urls 实现 ， 如 from Django.urls import include, path, re_path。 
admin 管理 系统 : 支持 主流 的 移动 设备 并 新 增 属性 ModelAdmin.autocomplete_ 
fields 和 方法 ModelAdmin.get_ autocomplete fields()。 

用 户 认证 : PBKDF2 密码 哈 希 默认 的 和 迭代 次 数 从 36 000 增加 到 100 000。 

Cache (缓存 ) : cache.set many() 现在 返回 一 个 列表 ， 包 含 了 插入 失败 的 键 值 。 
通用 视图 : ContextMixin.extra_context 属性 允许 在 View.as_view() 中 添加 上 下 文 。 
Pagination 〈 分 页 ) : 增加 Paginatorget page()， 可 以 处 理 各 种 非法 页 面 参 数 ， 
防止 异常 。 

Templates (模板 ) : 提高 Engine.get_default() 在 第 三 方 模块 的 用 途 。 

Validators (验证 器 ) : 不 允许 CharField 及 其 子 类 的 表单 输入 为 空 。 

File Storage (文件 存储 ) : File.open( 可 以 用 于 上 下 文 管理 器 ， 例 如 with file. 
open() as f。 

连接 MySQL 不 再 使 用 mysqldb 模块 ， 改 用 为 mysqlclient， 两 者 之 间 并 没有 太 
大 的 使 用 差异 。 

Management Commands (管理 命令 ) : inspectdb 将 MySQL 的 无 符号 整数 视 作 
PositiveIntegerField 或 者 PositiveSmallIntegerField 字段 类 型 。 


1.6 安装 Django 





为 了 符合 广大 读者 的 需求 ， 本 书 开发 环境 为 Windows 操作 系统 和 Python 3。 如 果 
部 分 读者 的 操作 系统 是 Linux 或 Mac OX， 可 在 虚拟 机 上 安装 Windows 操作 系统 。 

在 安装 Django 之 前 ， 首 先 安装 Python， 读 者 在 官网 下 载 .exe 安装 包 安 装 即 可 ， 
建议 安装 Python 3.5 或 以 上 的 版 本 。 完 成 Python 的 安装 后 ， 接 着 安装 Django， 安 装 
方法 如 下 : 

使 用 pip 进行 安装 ， 按 快捷 键 Windows+R 打开 运行 对 话 框 ， 然 后 在 对 话 框 中 输入 
cmd 并 按 回 车 键 , 进入 命令 提示 符 (也 称 为 终端 。 在 命令 提示 符 下 输入 以 下 安装 指令 : 
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pip install Django 

输入 指令 后 按 回 车 键 ， 会 自行 下 载 Django 2.0 版 本 并 安装 ， 我 们 只 需 等 待 安装 完 
成 即 可 。 
除了 使 用 pip 安装 之 外 ， 还 可 以 从 网 上 下 载 Django 的 压缩 包 自 行 安 装 。 在 浏 
览 器 上 输入 下 载 网 址 (https://www.lfd.uci.edu/~gohlke/pythonlibs/#sendkeys) 并 找到 
Django 的 下 载 链 接 ， 如 图 1-1 所 示 。 






































< Sa YP ct ethu/ ohlear phonlibe wandns P= BG 
dill-0.2. py3-none—any.wh 
distlib-0.2. 天 条 Pr 








distributed—1.20.2_py2.py3_none_any whl 
Diango-1.11.9-py2.py3-none-any -whl 
Diango-2.0.1-py3-none-any.whl 
dnslib-0.9.7-py2.py3-none-any whl 
docker-2.7.0-py2.pY3-none-any .whl 














图 1-1 Django 2.0 压缩 包 
然后 将 下 载 的 文件 放 到 王 盘 , 并 打开 CMD( 命 令 提 示 符 ) 窗 口 ,输入 以 下 安装 指令 
pip install E:\Django-2.0.1-py3-none-any.whl 
输入 指令 后 按 回 车 键 ， 等 待 安装 完成 的 提示 即 可 。 完 成 Django 的 安装 后 ， 需 要 


进一步 校 验 安装 是 否 成 功 ， 再 次 进入 CMD 窗口 ， 输 入 “python” 并 按 回 车 键 ， 进 入 
Python 交互 解释 器 ， 在 交互 解释 器 下 输入 校 验 代码 : 


























>>> import django 
>>> django. version _ 
'2.0.1" 


从 上 面 返回 的 结果 可 以 看 到 ， 当 前 安装 的 Django 版 本 为 2.0.1， 说 明 Django 安 
装 成 功 。 





1.7 创建 项 目 


一 个 项 目 可 以 理解 为 一 个 网 站 ， 创 建 Django 项 目 可 以 在 CMD 窗口 输入 创建 指 
令 完 成 。 在 CMD 窗口 下 输入 项 目 创建 指令 : 
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C:\Users\cxuser02>e: 
E:\>django-admin startproject MyDjango 


首先 第 一 行 指令 是 将 当前 路 径 切 换 到 E 盘 ， 然 后 使 用 创建 指令 创建 项 目 
MyDjango。 其 中 ，MyDjango 是 项 目 名 称 ， 读 者 可 自行 命名 。 项 目 创建 后 ， 可 以 在 EE 
盘 下 看 到 新 创建 的 文件 夹 MyDjango， 在 PyCharm 下 查看 该 项 目 结构 ， 如 图 1-2 所 示 。 
































BPproject ~ © 





MyDjango E:\MyDjango 
Y Ba MyDjango 

访 _init_.py 
访 settings.py 
六 urls.py 
隅 wsgi.py 

也 manage.py 

> 咱 External Libraries 








图 1-2 项 目 目录 结构 


项 目 MyDjango 中 包含 MyDjango 文件 夹 和 manage.py 文件 ， 而 MyDjango 文件 
夹 又 包含 4 个 .py 文件。 文件 说 明 如 下 。 

。 manage.py: 命令 行 工具 ， 允许 以 多 种 方式 与 项 目 进 行 交互 。 在 CMD 窗口 下 ， 
将 路 径 切 换 到 MyDjango 项 目 并 输入 python manage.py help， 可 以 查看 该 工具 
的 具体 功能 。 

e  _ init .py: 初始 化 文件 ， 一 般 情 况 下 无 须 修改 。 

e settings.py: 项 目的 配置 文件 ， 具 体 配置 说 明 会 在 下 一 章 详细 讲述 。 

e urls.py: 项 目的 URL 设置 ， 可 理解 为 网 站 的 地 址 信息 。 

ee wsgi.py: 全 称 为 Python Web Server Gateway Interface， 即 Python 服务 器 网 关 
接口 ， 是 Python 应 用 与 Web 服务 器 之 间 的 接口 ， 用 于 Django 项 目 在 服务 器 
上 的 部 署 和 上 线 ， 一 般 不 需要 修改 。 





完成 项 目的 创建 后 , 接着 创建 项 目 应 用 , 项 目 应 用 简称 为 App, 相当 于 网 站 的 功能 ， 
每 个 App 代表 网 站 的 一 个 或 多 个 网 页 。App 的 创建 由 文件 manage.py 实现 ， 创 建 指令 
如 下 : 
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E:\>cd MyDjango 
E:\MyDjango>python manage.py startapp index 


E:\MyDjango>python manage.py startapp user 








首先 从 王 盘 进 入 项 目 MyDjango， 然 后 使 用 python manage.py startapp XXX 创建 ， 


























中 XXX 是 应 用 的 名 称 , 读者 可 以 自行 命名 。 上 述 指令 分 别 创建 网 站 首页 和 用 户 中 心 ， 




















户 吕 


次 查看 项 目 MyDjango 的 目录 结构 ， 如 图 1-3 所 示 。 





MyDjango E\MyDjango 
v Bindex 
v Bmigrations 
及 jinit_.py 
缆 _init_.py 
篇 admin.py 
访 apps.py 
访 models.py 
访 tests.py 
访 views.py 
> Ba MyDjango 
> Buser 
齐 db.sqlite3 
访 manage.py 
> llll External Libraries 


图 1-3 项 目 MyDjango 目录 结构 











从 图 1-3 可 以 看 到 ， 项 目 新 建 了 index 和 user 文件 夹 ， 其 分 别 代 表 网 站 首页 和 用 





Pi 心 。 


在 index 文件 夹 可 以 看 到 有 多 个 .py 文件 和 migrations 文件 夹 ， 说 明 如 下 。 


migrations: 用 于 数据 库 数 据 的 迁移 。 

_ init .py: 初始 化 文件 。 

admin.py: 当前 App 的 后 台 管理 系统 。 

apps.py: 当前 App 的 配置 信息 ， 在 Django 1.9 版 本 后 自动 生成 ， 一 般 情况 下 

无 须 修改 。 

models.py: 定义 映射 类 关联 数据 库 ， 实 现 数据 持久 化 ， 即 MTV 里 面 的 模型 
(Model) 。 

tests.py: 自动 化 测试 的 模块 。 

Views.py: 逻辑 处 理 模块 ， 即 MTV 里 面 的 视图 (Views) 。 
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完成 项 目 和 App 的 创建 后 ， 最 后 在 CMD 窗口 输入 以 下 指令 启动 项 目 : 


C:\Users\cxuser02>e: 
E:\>cd MyDjango 
E:\MyDjango>python manage.py runserver 80 





首先 将 路 径 切 换 到 项 目的 路 径 ， 然 后 输入 python manage.py runserver 80， 其 中 80 











是 端口 号 ， 如 果 不 设置 端口 ， 默 认为 8000， 最 后 
可 看 到 项 目的 启动 情况 ， 如 图 1-4 所 示 。 




















erver 89 


System check identified no iss s《9 silenced). 


Nou have 14 unapplied migrationCs). Your project may not wo 
apply the m ions for appCs): adnin, auth, contenttypes, 
“pytho e - rate’ to apply them- 
ry 39。 
1。 using settings ’MyDjango.settings’ 
st arting d lopment se at http: -9.9.1:898 
Quit the er with CTRL-BREAK. 





在 浏览 器 上 输入 http://127.0.0.1:80/ 


properly until you 





django 





The install worked succe: 











eleose notes for Django 20 




















1.8 PyCharm 搭建 开发 环境 


除了 在 CMD 窗口 创建 项 目 之 外 ， 还 可 以 在 PyCharm 下 创 

















建 项 目 ， 打 开 PyCharm 





并 在 左上 方 单 击 File 一 New Project 创建 新 项 目 ， 如 图 1-5 所 示 。 
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WW Angular CU 

WW Angulans 
Foundation 

目 HTML5 Boilerplate 


名 React App 

各 React Native 

加 Twiner Bootstrap 
《》 Web Starter Kit 


项 目 创建 后 ， 可 以 看 到 目 
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Location。。 [EAMyDjango 














Interpreter 盛 3.5.4 at E\Python\python.exe 











™ More Settings 





Template language: Django 





Templates folder: 。 templates 
Application name: 
回 Enable Django admin 





图 1-5 在 PyCharm 下 创建 Django 


HTML 文件 ， 如 图 1-6 所 示 。 











| 国 pProjec > 全 站 | 次" 全 
MyDjango E:\MyDjango 
v BMyDjango 
访 _init_.py 
了 settings.py 
访 urls.py 
竟 wsgi.py 
Ml templates 
齐 manage.py 
> 川 External Libraries 














图 1-6 项 目 目录 结构 


录 结 构 多 出 了 templates 文件 夹 ， 该 文件 夹 用 于 存放 


接着 创建 App， 可 以 在 PyChram 的 Terminal 中 输入 创建 指令 ， 创 建 指令 与 在 


CMD 窗口 下 输入 的 相同 ， 分 别 创建 网 站 首页 和 用 户 中 心 ， 如 图 

















1-7 所 示 。 
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十 (ec) 2013 licrosoft Corporation。 保留 所 有 权利 。 


E:\MyDjango’python manage.py startapp index 








SPython console I 4 所 srooo 
国 Tests Passed: 0 passed (8 minutes ago) 


图 1-7 在 PyCharm 下 创建 App 

















完成 项 目 和 App 的 创建 后 ， 最 后 启动 项 目 。 如 果 项 目 是 由 PyCharm 创建 的 ， 可 
直接 单 击 “ 运 行 ” 按 钮 启动 项 目 ， 如 图 1-8 所 示 。 





[ 团 Mpjango | > 多 路 四 至 目 QQ 


aseqeeq 伸 。 weAmedq 图 








1-8 在 PyCharm 启动 项 目 


如 果 项 目 是 由 CMD 窗口 创建 的 ， 想 要 在 PyCharm 启动 项 目 ， 就 需要 对 该 项 目 
进行 配置 ， 首 先 创建 运行 脚本 ， 如 图 1-9 所 示 。 





Q 
加 
2 
FE3 
5 
目 
已 
上 





图 1-9 创建 运行 脚本 
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单 击 图 1-9 中 的 Edit Configurations 就 会 出 现 Run/Debug Configurations 界面 ， 然 








后 单 击 该 界面 左上 方 的 二 
图 1-10 所 示 。 














1.9 本 章 小 结 


























选择 Django server， 单 击 OK 按钮 即 可 创建 运行 脚本 ， 如 


sm) se 口 soeiaoneomy 
JE | 
Host 
addidonal optons 
口 Run browser: api27Ga13000 
Start Javascript debugger automaticaly when debuggin 
口 Custom run command: 
DD Test server 
口 Ne load 
mrment 
Sironmentvarables [PYTHONUNBUFFERED=1 
Bynon interpreter | Pyhon 354(EWythonpythoneej 
Imterpreter opiions: 





Werkieg directory 
Add content rocts to PYTHONPATH 
回 Add source reots to PYTHONPATH 


™ Before launch: Activate tool window 
TP 


口 shew sis page 回 Activate tocl window 


图 1-10 创建 运行 脚本 


























网 站 〈Website) 是 指 在 因特网 上 根据 一 定 的 规则 ， 使 用 HIML (标准 通用 标记 


























语言 下 的 一 个 应 用 ) 等 工具 制作 并 用 于 展示 特定 内 容 相关 网 页 的 集合 。 在 早期 , 域名、 


空间 服务 器 与 程序 是 网 站 的 基本 组 成 部 分 ， 随 着 科技 的 不 断 进步 ， 网 站 的 组 成 也 日 趋 

















复杂 ， 目 前 多 数 网 站 由 域名 、 空 间 服务 器 、DNS 域名 解析 、 网 站 程序 和 数据 库 等 组 成 。 





网 站 开发 流程 如 下 。 


。 需求 分 析 : 当 拿 到 一 个 项 目 时 ， 必 须 进行 需求 分 析 ， 清 楚 知 道 网 站 的 类 型 、 
具体 功能 、 业 务 逻 辑 以 及 网 站 的 风格 ， 此 外 还 要 确定 域名 、 网 站 空间 或 者 服 
务 器 以 及 网 站 备案 等 。 
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规划 静态 内 容 : 重新 确定 需求 分 析 ， 并 根据 用 户 需求 规划 出 网 站 的 内 容 板块 
草图 。 

设计 阶段 : 根据 网 站 草图 ， 由 美工 制作 成 效果 图 。 就 好 比 建 房子 一 样 ， 首 先 
画 出 效果 图 ， 然 后 才 开 始 建 房子 ， 网 站 开发 也 是 如 此 。 

程序 开发 阶段 :根据 草图 划分 页 面 结构 和 设计 ， 前 端 和 后 台 可 以 同时 进行 。 
前 端 根据 美工 效果 负责 制作 静态 页 面 ， 后 台 根 据 页 面 结 构 和 设计 ， 设 计数 据 
库 数 据 结 构 和 开发 网 站 后 台 。 

测试 和 上 线 : 在 本 地 搭建 服务 器 ， 测 试 网 站 是 否 存 在 BUG。 若 无 问题 ， 则 可 
以 将 网 站 打包 ， 使 用 FTP 上 传 至 网 站 空间 或 者 服务 器 。 

维护 推广 在 网 站 上 线 之 后 , 根据 实际 情况 完善 网 站 的 不 足 , 定期 修复 和 升级 ， 
保障 网 站 运营 顺畅 ， 然 后 对 网 站 进行 推广 宣传 等 。 


Django 采 用 MTYV 的 框架 模式 , 即 模型 (Model) 、 模 板 (Template) 和 视图 (Views)， 
三 者 之 间 各 自负 责 不 同 的 职责 。 


模型 ， 数 据 存 取 层 ， 处 理 与 数据 相关 的 所 有 事务 ， 例 如 如 何 存 取 、 如 何 验证 
有 效 性 、 包 含 哪些 行为 以 及 数据 之 间 的 关系 等 。 

视图 ， 表 现 层 ， 处 理 与 表现 相关 的 决定 ， 例 如 如 何在 页 面 或 其 他 类 型 文档 中 
进行 显示 。 

模板 , 业务 逻辑 层 , 存 取 模 型 及 调 取 恰 当 模 板 的 相关 逻辑 , 模型 与 模板 的 桥梁 。 


Django 的 安装 建议 使 用 pip 执行 安装 ， 安 装 的 方法 如 下 : 


# 方法 一 

pip install Django 

# 方法 二 

pip install E:\Django-2.0.1-py3-none-any.whl 

两 种 不 同 的 安装 方法 都 是 使 用 pip 执行 的 ， 唯 一 不 同 在 于 前 者 在 安装 过 程 中 会 从 
互联 网 下 载 安 装 包 ， 而 后 者 直接 对 本 地 已 下 载 的 安装 包 进 行 解压 安装 。Django 安装 
完成 后 ， 在 Python 交互 解释 器 模式 校 验 安装 是 否 成 功 : 


>>> import django 


>>> django. version 
2 
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创建 Django 项 目 可 以 在 CMD 窗口 下 输入 django-admin startproject MyDjango 
完成 ， 也 能 在 PyCharm 下 完成 创建 。 创 建 App 由 manage.py 实现 ， 在 CMD 窗口 或 
PyCharm 的 Terminal 中 输入 python manage.py startapp XXX 完成 App 的 创建 ， 其 中 
XXX 是 应 用 的 名 称 ， 读 者 可 以 自行 命名 。 项 目 创建 后 ， 需 要 掌握 Django 的 目录 结构 
以 及 含义 。 


manage.py: 命令 行 工具 ， 人 允许 以 多 种 方式 与 项 目 进行 交互 。 在 CMD 窗口 下 ， 
将 路 径 切 换 到 MyDjango 项 目 并 输入 python manage.py help， 可 以 查看 该 工具 
的 具体 功能 。 

_ init .py: 初始 化 文件 ， 一 般 情况 下 无 须 修改 。 

settings.py: 项 目的 配置 文件 ， 具 体 配置 说 明 会 在 下 一 章 详细 讲述 。 

urlspy: 项 目的 URL 设置 ， 可 理解 为 网 站 的 地 址 信息 。 

Wsgi.py: 全 称 为 Python Web Server Gateway Interface， 即 Python 服务 器 网 关 
接口 ， 是 Python 应 用 与 Web 服务 器 之 间 的 接口 ， 用 于 Django 项 目 在 服务 器 
上 的 部 署 和 上 线 ， 一 般 不 需要 修改 。 

migrations: 用 于 数据 库 数据 的 迁移 。 

admin.py: 当前 App 的 后 台 管理 系统 。 

apps.py: 当前 App 的 配置 信息 ， 在 Diango 1.9 版 本 后 自动 生成 ， 一 般 情况 下 
无 须 修 改 。 


models.py: 定义 映射 类 关联 数据 库 ， 实 现 数据 持久 化 ， 即 MTV 里 面 的 模型 
(Model) 。 


tests.py: 自动 化 测试 的 模块 。 
Views.py: 逻辑 处 理 模 块 ， 即 MTV 里 面 的 视图 (Views) 。 
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项 目 配置 是 根据 实际 开发 需求 从 而 对 整个 Web 框架 编写 相关 配置 信息 。 配 置信 
息 主 要 由 项 目的 settings.py 实现 ， 主 要 配置 有 项 目 路 径 、 密 钥 配 置 、 域 名 访问 权限 、 
App 列表 、 配 置 静态 资源 、 配 置 模板 文件 、 数 据 库 配 置 、 中 间 件 和 缓存 配置 。 


2.1 基本 配置 信息 


一 个 简单 的 项 目 必须 具备 的 基本 配置 信息 有 : 项 目 路 径 、 密 钥 配置 、 域 名 访问 权 
限 、App 列表 和 中 间 件 。 以 MyDjango 项 目 为 例 ，settings.py 的 基本 配置 如 下 : 





import os 

# 项 目 路 径 

# Build paths inside the project like this: os.path.join(BASE DIR, ...) 
BASE DIR = os.path.dirname (os.path.dirname (os.path.abspath( file ))) 
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# 密 钥 配置 
# SECURITY WARNING: keep the secret key used in production secret! 
SECRET KEY = '@p m’^!ha=$6m$9#m%gobzog&gb0^g2o0bt4teod84xs6=f%$4a66x' 
# SECURITY WARNING: don't run with debug turned on in production! 
# 调试 模式 
DEBUG = True 
# 域名 访问 权限 
ALLOWED HOSTS = [] 
# App 列表 
# Application definition 
INSTALLED APPS = [ 
'django.contrib.admin', 
'django.contrib.auth', 
"django .contrib.contenttypes'v 
"django .contrib.sessions'v 
"django .contrib.messages'v 
"django .contrib.staticfiles'v 


] 

上 述 代 码 列 出 了 项 目 路 径 BASE DIR、 密 钥 配 置 SECRET KEY、 调 试 模式 
DEBUG、 域 名 访问 权限 ALLOWED_HOSTS 和 App 列表 INSTALLED APPS， 各 个 
配置 说 明 如 下 。 

项 目 路 径 BASE_DIR: 主要 通过 os 模块 读 取 当 前 项 目 在 系统 的 具体 路 径 ， 该 代 
码 在 创建 项 目 时 自动 生成 ， 一 般 情 况 下 无 须 修改 。 

密 钥 配置 SECRET KEY: 是 一 个 随机 值 ， 在 项 目 创 建 的 时 候 自动 生成 ， 一 般 情 
况 下 无 须 修改 。 主 要 用 于 重要 数据 的 加 密 处 理 ， 提 高 系统 的 安全 性 ， 避 免 遭 到 攻击 者 
恶意 破坏 。 密 钥 主 要 用 于 用 户 密码 、CSRF 机 制 和 会 话 Session 等 数据 加 密 。 


日 用 户 密码 : Django 内 置 一 套用 户 管理 系统 ， 该 系统 具有 用 户 认证 和 存储 用 户 
信息 等 功能 ， 在 创建 用 户 的 时 候 ， 将 用 户 密码 通过 密 钥 进行 加 密 处 理 ， 保 证 


用 户 的 安全 性 。 
eCSRF 机 制 : 该 机 制 主要 用 于 表单 提交 ， 防 止 窃取 网 站 的 用 户 信 息 来 制造 恶意 


@ 会话 Session: Session 的 信息 存放 在 Cookies， 以 一 串 随 机 的 字符 串 表 示 ， 用 
于 标识 当前 访问 网 站 的 用 户 身份 ， 记 录 相 关 用 户 信息 。 


调试 模式 DEBUG: 该 值 为 布尔 类 型 。 如 果 在 开发 调试 阶段 应 设置 为 Tue， 在 开 
发 调试 过 程 中 会 自动 检测 代码 是 否 发 生 更 改 ， 根 据 检测 结果 执行 是 否 刷新 重启 系统 。 


be) 
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如 果 项 目 部 署 上 线 ， 应 将 其 改 为 False， 否 则 会 泄漏 系统 的 相关 信息 。 

域名 访问 权限 ALLOWED HOSTS: 设置 可 访问 的 域名 ， 默 认 值 为 空 。 
当 DEBUG 为 True 并 且 ALLOWED HOSTS 为 空 时 ， 项 目 只 允许 以 localhost 或 
127.0.0.1 在 浏览 器 上 访问 。 当 DEBUG 为 False 时 ，ALLOWED HOSTS 为 必 填 项 ， 
否则 程序 无 法 启动 ， 如 果 想 允许 所 有 域名 访问 ， 可 设置 ALLOW_HOSTS=['*']。 

App 列表 INSTALLED APPS: 告诉 Django 有 哪些 App。 在 项 目 创建 时 已 有 
admin、auth 和 session 等 配置 信息 ， 这 些 都 是 Django 内 置 的 应 用 功能 ， 各 个 功能 说 
明 如 下 。 


。 admin: 内 置 的 后 台 管 理 系统 。 

。 auth: 内 置 的 用 户 认 证 系统 。 

e ”contenttypes: 记录 项 目 中 所 有 model 元 数据 (Django 的 ORM 框架 ) 。 

e@ sessions: Session 会 话 功能 ， 用 于 标识 当前 访问 网 站 的 用 户 身份 ， 记 录 相 关 用 
户 信息 。 

e messages: 消息 提示 功能 。 

e staticfiles: 查找 静态 资源 路 径 。 


如 果 在 项 目 创建 了 App， 必 须 在 App 列表 INSTALLED APPS 添加 App 名 称 。 
将 MyDjango 项 目 已 创建 的 App 添加 到 App 列表 ， 代 码 如 下 : 


INSTALLED APPS = [ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'index', 


user', 


2.2 静态 资源 


静态 资源 指 的 是 网 站 中 不 会 改变 的 文件 。 在 一 般 的 应 用 程序 中 ， 静 态 资源 包括 
CSS 文件 、JavaScript 文件 以 及 图 片 等 资源 文件 。 此 处 简单 介绍 CSS 和 JavaScript 文 件 。 
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CSS 也 称 层 闭 样式 表 (Cascading Style Sheets) ， 是 一 种 用 来 表现 HIML (标准 
通用 标记 语言 的 一 个 应 用 ) 或 XML (标准 通用 标记 语言 的 一 个 子 集 〉 等 文件 样式 的 
计算 机 语言 。CSS 不 仅 可 以 静态 地 修饰 网 页 ， 还 可 以 配合 各 种 脚本 语言 动态 地 对 网 页 
各 元 素 进行 格式 化 。 

JavaScript 是 一 种 直译 式 脚 本 语言 , 也 是 一 种 动态 类 型 、 弱 类 型 、 基 于 原型 的 语言 ， 
内 置 支持 类 型 。 它 的 解释 器 被 称 为 JavaScript 引擎 ， 为 浏览 器 的 一 部 分 ， 广 泛 用 于 客 
户 端的 脚本 语言 ， 最 早 是 在 HTML (标准 通用 标记 语言 下 的 一 个 应 用 ) 网 页 上 使 用 的 ， 
用 来 给 HTML 网 页 增加 动态 功能 。 

一 个 项 目 在 开发 过 程 中 肯定 需要 使 用 CSS 和 JavaScript 文件 ， 这 些 静 态 文件 的 存 
放 主 要 由 配置 文件 settings.py 设置 ， 配 置信 息 如 下 : 






















































































# Static files (CSS, JavaSscript, Images) 
# https://docs.djangoproject.com/en/2.0/howto/static-files/ 
STATIC URL = '/static/' 


上 述 配 置 将 静态 资源 存放 在 文件 夹 static， 而 文件 夹 static 只 能 放 在 App 里 面 
当 项 目 启动 时 ，Django 会 根据 静态 资源 存放 路 径 去 查找 相关 的 资源 文件 ， 查 找 功 能 
主要 由 App 列表 INSTALLED APPS 的 staticfiles 实现 。 在 index 中 添加 文件 夹 static 
并 在 文件 夹 放 置 图 片 ， 如 图 2-1 所 示 。 




















MyDjango E:\MyDjango 
v Bindex 
> Bmigrations 
Y DB static 
司 index_picpng 








图 2-1 static 文件 夹 信息 


启动 项 目 程序 后 ， 在 浏览 器 上 访问 http://127.0.0.1:8000/static/index_pic.png， 可 
以 看 到 图 片 展 现在 浏览 器 中 。 如 果 将 static 文件 夹 放 置 在 MyDjango 的 根 目 录 下 ， 在 
浏览 器 上 会 显示 404 无 法 访问 的 异常 信息 。 

如 果 想 在 MyDjango 的 根 目录 下 存放 静态 资源 ， 可 以 在 配置 文件 settings.py 中 设 
置 STATICFILES_DIRS 属性 。 该 属性 以 列表 的 形式 表示 ， 设 置 方式 如 下 : 





# 设置 根 目录 的 静态 资源 文件 夹 public_static 


STATICFILES DIRS = [os.path.join(BASE DIR, ‘public static'), 
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# 设置 App (index) 的 静态 资源 文件 夹 index_static 


os.path.join(BASE DIR, ' index/index static | 


分 别 在 项 目的 根 目录 下 添加 文件 夹 public_static 和 在 App 中 添加 文件 夹 index_ 
static， 在 这 两 个 文件 夹 下 分 别 放 置 相应 的 图 片 ， 如 图 2-2 所 示 。 








MyDjango E:\MyDjango 





v Paindex A 
v Dindex static v 
图 index_pic1.png 司 public_picpng 
> 加 migrations > Pa templates 





图 2-2 左 侧 为 index_static 文件 夹 的 信息 ， 右 侧 为 public_static 文件 夹 的 信息 





启动 项 目 程序 后 ， 在 浏览 器 上 分 别 输入 地 址 http://127.0.0.1:8000/static/public_pic. 
png 和 http://127.0.0.1:8000/static/index_picl.png， 可 以 看 到 静态 资源 的 内 容 展 现在 浏 
览 器 上 。 

从 上 面 的 例子 可 以 看 到 ， 配 置 属 性 STATIC_URL 和 STATICFILES_DIRS 存在 明 
显 的 区 别 。 


e@ STATIC URL 是 必须 配置 的 属性 而 且 属 性 值 不 能 为 空 。 如 果 没 有 配置 
STATICFILES_DIRS， 则 STATIC_URL 只 能 识别 App 里 的 static 静态 资源 文 
件 夹 。 

e@ STATICFILES_DIRS 是 可 选 配置 属性 , 属性 值 为 列表 或 元 组 格式 , 每 个 列表 (元 
组 ) 元 素 代表 一 个 静态 资源 文件 夹 ， 这 些 文件 夹 可 自行 命名 。 

e 在 浏览 器 上 访问 项 目的 静态 资源 时 ， 无 论 项 目的 静态 资源 文件 夹 是 如 何 命 名 
的 ， 在 浏览 器 上 ， 静 态 资 源 的 上 级 目录 必须 为 static， 而 static 是 STATIC 
URL 的 属性 值 ， 因 为 STATIC URL 也 是 静态 资源 的 起 始 URL。 














除 此 之 外 ， 静 态 资 源 配 置 还 有 STATIC ROOT， 其 作用 是 方便 在 服务 器 上 部 署 
项 目 ， 实 现 服务 器 和 项 目 之 间 的 映射 。STATIC ROOT 主要 收集 整个 项 目的 静态 资源 
并 存放 在 一 个 新 的 文件 夹 ， 然 后 由 该 文件 夹 与 服务 器 之 间 构 建 映射 关系 。STATIC_ 
ROOT 配置 如 下 : 





STATIC ROOT = os.path.join(BASE DIR, "all static') 


STATIC ROOT 用 于 项 目 生产 部 署 ， 在 项 目 开 发 过 程 中 作用 不 大 ， 关 于 STATIC_ 
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ROOT 的 使 用 会 在 第 11 章 11.13 节 详 细 讲 述 。 


2.3 模板 路 径 


在 Web 开发 中 ， 模 板 是 一 种 较为 特殊 的 HIML 文档 。 这 个 HIML 文档 嵌入 了 
一 些 能 够 让 Python 识别 的 变量 和 指令 ， 然 后 程序 解析 这 些 变量 和 指令 ， 生 成 完整 的 
HTML 网 页 并 返回 给 用 户 浏览 。 模 板 是 Django 里 面 的 MTV 框架 模式 的 了 部 分 ， 配 
置 模板 路 径 是 告诉 Django 在 解析 模板 时 ， 如 何 找到 模板 所 在 的 位 置 。 创 建 项 目 时 ， 
Django 已 有 初始 的 模板 配置 信息 ， 如 下 所 示 : 





TEMPLATES = [ 
{ 

'BACKEND': 'django.template.backends.django.DjangoTemplates', 

"DIRS": [ls 

'APP_DIRS': True, 

?OPTIONS ': { 

"context_Processors': [ 

'django.template.context processors.debug', 
'django.template.context processors.request', 
'django.contrib.auth.context processors.auth', 
'django.contrib.messages.context processors.messages', 


}, 
] 


模板 配置 是 以 列表 格式 呈现 的 ， 每 个 元 素 具 有 不 同 的 含义 ， 其 含义 说 明 如 下 。 


。 BACKEND: 定义 模板 引擎 ， 用 于 识别 模板 里 面 的 变量 和 指令 。 内 置 的 模板 
引擎 有 Django Templates 和 jinja2.Jinja2， 每 个 模板 引擎 都 有 自己 的 变量 和 指 
令 语 法 。 

ee DIRS: 设置 模板 所 在 路 径 ， 告 诉 Django 在 哪个 地 方 查找 模板 的 位 置 ， 默 认 
为 空 列 表 。 

e APP DIRS: 是 否 在 App 里 查找 模板 文件 。 

ee OPTIONS: 用 于 填充 在 RequestContext 中 上 下 文 的 调用 函数 ， 一 般 情 况 下 不 
做 任何 修改 。 
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模板 配置 通常 配置 DIRS 的 模板 路 径 即 可 。 在 项 目的 根 目录 和 index 下 分 别 创建 
templates 文件 夹 ， 并 在 文件 夹 下 分 别 创建 文件 index.html 和 app_index.html， 如 图 2-3 
所 示 。 




















Y MMyDjango EMyDjango 
Y Bindex 
> 加 migrations 


> Bn public_static 
Y Dtemplates 
index.html 


2-3 模板 配置 信息 








根 目 录 的 templates 通常 存放 共用 的 模板 文件 ， 能 够 供 各 个 App 的 模板 文件 调用 ， 
该 模式 符合 代码 重复 使 用 的 原则 ， 如 HTML 的 <head> 部 分 。index 的 templates 是 存 
放 当 前 App 所 需要 使 用 的 模板 文件 。 根 据 图 2-3 的 设置 ， 模 板 配置 代码 如 下 : 


TEMPLATES = [ 
{ 
'BACKEND': '‘'django.template.backends.django.DjangoTemplates', 
'DIRS': [os.path.join(BASE DIR, 'templates'), 
os.path.join (BASE _DIR, 'index/templates')], 
'APP_DIRS': True, 
'OPTIONS': { 
'context processors': [ 

'django.template.context processors.debug', 
'django.template.context processors.request', 
"django .contrib .auth.context_Processors .auth'v 
'django.contrib.messages.context processors.messages', 
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2.4 数据 库 配置 


数据 库 配置 是 选择 项 目 所 使 用 的 数据 库 的 类 型 ， 不 同 的 数据 库 需 要 设置 不 同 的 
实现 项 目 与 数据 库 的 连接 , Django 提供 4 种 数据 库 引 擎 : 








数据 库 引 擎 , 数据 库 引 擎 用 了 

'django.db.backends .postgresqgl' 
'django.r 
'django.c 
'django. 
项 目 创建 时 默认 使 用 Sqlite3 数据 库 ， 这 是 
源 非常 。Sqlite3 数据 库 配置 信息 如 下 : 






sqlite3"' 





db.backends .oracle' 


轻型 的 数据 库 ， 常 用 于 媒 入 式 系 





次 


统 开 发 ， 而 且 占用 的 资 


DATABASES = { 


'default': { 
'ENGINE': 'django.db.backends.sqlite3', 
'NAME': os.path.join(BASE DIR, 'db.sqlite3'), 


} 
如 果 把 上 述 的 连接 信息 改 为 MySQL 数据 库 ， 首 先 安装 MySQL 连接 模块 ， 由 于 
竺 Python 3, 因此 Django 2.0 不 再 使 用 mysqldb 作为 MySQL 的 连接 模块 ， 


mysqldb 不 文 
而 选择 了 mysqlclient 模块 ， 两 者 之 间 在 使 用 上 并 没有 太 大 的 差异 。 


在 配置 MySQL 之 前 ， 首 先 安装 mysqlclient 模块 ， 这 里 以 pip 安装 方法 为 例 ， 打 
装 完成 。 然 后 检测 






等 待 模板 安 





开 CMD 窗口 并 输入 安装 指令 pip install mysqlclient， 
mysqlclient 的 版 本 信息 , 如 果 mysqlclient 版 本 信息 过 低 , 就 不 符合 Django 的 使 用 要 求 。 
在 CMD 窗口 











进入 Python 交互 解释 器 进行 版 本 验证 ， 如 图 2-4 所 示 。 


?98 64 bit 《hnhMD647>] 


6838 。hug 
for more information. 


pyright"-。 ' 








2-4 mysqlclient 版 本 信息 











能 符合 Diango 的 使 用 要 求 。 如 果 


一 般 情 况 下 ， 使 用 pip 安装 mysqlclient 模块 都 能 符 
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在 开发 过 程 中 发 现 Django 提示 mysqlclient 过 低 ， 而 且 mysqlclient 的 版 本 又 大 于 1.3.3 
版 本 ， 那 么 可 以 对 Django 的 源码 进行 修改 ， 在 Python 的 安装 目录 下 找到 base CLib 
site-packagesvdjangovdb\backendsmysql\basepy) 文件 ， 在 文件 中 找到 如 图 2-5 所 示 的 
































代码 并 将 其 注释 掉 : 
Erom MySQLdb. constants import CLIENT, FIELD TYPE ark skip 
from MySQLdb.converters import conversions # 4a0rk:skip 


# Some of these import MYSQLdb，ao import them after checking if it's installed. 


from .client import DatabaseClient # 1aork:skip 
from .creation import DatabaseCreation 条 3RXK:skip 
from ,features import DatabaseFeatures # Agark:skip 
from .introspection import DatabaseIntrospection # inQKk: skip 
from .operations import DatabaseOperations § nork:skip 
from -schema import DatabaseschemaEditor # hg: skip 
from .validation import DatabaseValidation # haRKK: Skip 


version = Database.version info 














2-5 注释 Django 源码 


完成 mysqlclient 模块 的 安装 后 ， 在 项 目的 配置 文件 settings.py 中 配置 MySQL 数 
据 库 连接 信息 ， 代 码 如 下 : 


DATABASES = { 
'default': { 
'ENGINE': 'django.db.backends.mysql', 
'NAME': 'django db', 
USER’:'root', 
'PASSWORD' : '1234', 
HOST TI27.9.0.177 
'PORT':'3306', 


} 


上 述 连 接 方式 用 于 连接 MySQL 里 面 一 个 名 为 django_db 的 数据 库 ， 上 述 配 置 
是 连接 了 一 个 django_db 数据 库 。 在 日 常 的 开发 中 ， 有 时 候 需 要 连接 多 个 数据 库 ， 
现 方法 如 下 : 

















将 并 





DATABASES = { 


# 第 一 个 数据 库 
'default': { 
'ENGINE': ‘django.db.backends.mysqgl', 
'NAME': ‘django db', 


USER1 :root', 
'PASSWORD' : '1234"', 
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ROSEY ET 37 
ORP "S36 
}, 

# 第 二 个 数据 库 

'MyDjango': { 
'ENGINE': ‘django.db.backends.mysql', 
'NAME': 'MyDjango db', 
"yoER" "root', 
"PRSSWORD' : '1234"', 
'HOST':"'127.0.0.1°', 
“PORT 3306"7 


]v 
# 第 三 个 数据 库 
"my_sqlite37: { 
'ENGINE': 'django.db.backends.sqlite3', 
'NAME': os.path.join(BASE DIR, 'sqlite3'), 
}, 
} 


上 述 代 码 共 连接 三 个 数据 库 ， 分 别 是 django_db、MyDjango_db 和 Sqlite3。 
django_db 和 MyDjango_db 均 属 于 MySQL 数据 库 系 统 ，Sqlite3 属于 Sqlite3 数据 库 系 
统 。 从 属性 DATABASES 的 数据 类 型 可 以 发 现 是 一 个 Python 的 数据 字典 ， 也 就 是 说 
如 果 需 要 连接 多 个 数据 库 ， 只 要 在 属性 DATABASES 中 设置 不 同 的 键 值 对 即 可 实现 。 

值得 注意 的 是 ， 本 书 是 以 MySQL 的 5.7 版 本 为 例 进行 介绍 的 。 如 果 读 者 使 
用 的 是 5.7 以 上 的 版 本 ， 在 Django 连接 MySQL 数据 库 时 会 提示 django.db.utils. 
OperationalError 的 错误 信息 ， 这 是 因为 MySQL 8.0 版 本 的 密码 加 密 方式 发 生 了 改变 ， 
8.0 版 本 的 用 户 密码 采用 的 是 cha2 加 密 方 法 。 

为 了 解决 这 个 问题 ， 我 们 通过 SQL 语句 将 8.0 版 本 的 加 密 方法 改 回 原来 的 加 密 
方式 ， 这 样 可 以 解决 Django 连接 MySQL 数据 库 的 错误 问题 。 在 MySQL 的 可 视 化 工 
具 中 运行 以 下 SQL 语句 : 


#newpassword 是 我 们 设置 的 用 户 密码 

ALTER USER ‘root'@'localhost' IDENTIFIED WITH mysql native password BY 
'newpassword'; 

FLUSH PRIVILEGES; 


Django 除 了 支持 PostgreSQL、Sqlite3、MYySQL 和 Oracle 之 外 ， 还 支 持 
SQLServer 和 MongoDB 的 连接 。 由 于 不 同 的 数据 库 有 不 同 的 连接 方式 ， 此 处 不 过 多 
介绍 ， 本 书 主要 以 MySQL 连接 为 例 ， 若 需 了 解 其 他 数据 库 的 连接 方式 ， 可 自行 搜索 
相关 资料 。 
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2.5 中 间 件 


中 间 件 (Middleware) 是 处 理 Django 的 request 和 response 对 象 的 钩子 。 当 用 户 
在 网 站 中 进行 单 击 某 个 按钮 等 操作 时 ， 这 个 动作 是 用 户 向 网 站 发 送 请 求 (request) ; 
而 网 页 会 根据 用 户 的 操作 返回 相关 的 网 页 内 容 ， 这 个 过 程 称 为 响应 处 理 (response) 。 
从 请 求 到 响应 的 过 程 中 ， 当 Django 接收 到 用 户 请 求 时 ，Django 首先 经 过 中 间 件 处 理 
请 求 信息 ， 执 行 相关 的 处 理 ， 然 后 将 处 理 结果 返回 给 用 户 ， 中 间 件 执行 流程 如 图 2-6 
所 示 。 





HttpRequest HttpResponse 
要 
7 





Process template response _ cu 


下 





Fy 
o 
5 
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Process_ response 


AuthenticationMiddlewar! 


Proces 











三 | 1 
view function ) 


图 2-6 中 间 件 执行 流程 


从 图 2-6 中 能 清晰 地 看 到 ， 中 间 件 的 作用 主要 是 处 理 用 户 请 求 信息 。 开 发 者 也 
可 以 根据 自己 的 开发 需求 自 定 义 中 间 件 ， 只 要 将 自 定义 的 中 间 件 添加 到 配置 属性 
MIDDLEWARE 中 即 可 激活 。 一 般 情况 下 ，Django 默认 的 中 间 件 配置 均 可 满足 大 部 
分 的 开发 需求 。 在 项 目的 MIDDLEWARE 中 添加 LocaleMiddleware 中 间 件 ， 使 得 
Diango 内 置 的 功能 支持 中 文 显示 ， 代 码 如 下 : 


MIDDLEWARE = [ 
'django.middleware.security.SecurityMiddleware', 
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'django.contrib.sessions.middleware.SessionMiddleware', 
# 使 用 中 文 


'django.middleware.locale.LocaleMiddleware', 














"django .middleware.common.CommonMiddleware', 
'django.middleware.csrf.CsrfViewMiddleware', 
'django.contrib.auth.middleware.AuthenticationMiddleware', 
'django.contrib.messages.middleware.MessageMiddleware', 
"'django.middleware.clickjacking.XFrameOptionsMiddleware', 


配置 属性 MIDDLEWARE 的 数据 格式 为 列表 类 型 ， 每 个 中 间 件 的 设置 顺序 是 固 
定 的 ， 如 果 随 意 变更 中 间 件 很 容易 导致 程序 异常 。 每 个 中 间 件 的 说 明 如 下 : 


SecurityMiddleware: 内 置 的 安全 机 制 ， 保 护 用 户 与 网 站 的 通信 安全 。 
SessionMiddleware: 会 话 Session 功能 。 

LocaleMiddleware: 支持 中 文 语言 。 

CommonMiddleware: 处 理 请 求 信息 ， 规 范 化 请 求 内 容 。 
CsrfViewMiddleware: 开启 CSRF 防护 功能 。 
AuthenticationMiddleware: 开启 内 置 的 用 户 认 证 系统 。 
MessageMiddleware: 开启 内 置 的 信息 提示 功能 。 
XFrameOptionsMiddleware: 防止 恶意 程序 点 击 动 持 。 


2.6 本 章 小 结 





项 目 配置 是 根据 实际 开发 需求 从 而 对 整个 Web 框架 编写 相关 配置 信息 。 配 置信 
息 主 要 由 项 目的 settings.py 实现 ， 主 要 配置 有 项 目 路 径 、 密 钥 配 置 、 域 名 访问 权限 、 
App 列表 、 配 置 静态 资源 、 配 置 模板 文件 、 数 据 库 配 置 、 中 间 件 和 缓存 配置 。 

当 DEBUG 为 True 并 且 ALLOWED_HOSTS 为 空 时 ， 项 目 只 允许 以 localhost 或 
127.0.0.1 在 浏览 器 上 访问 。 当 DEBUG 为 False 时 ，ALLOWED HOSTS 为 必 填 项 ， 
否则 程序 无 法 启动 ， 如 果 想 允许 所 有 域名 访问 ， 可 设置 ALLOW_HOSTS =['*']。 

App 列表 INSTALLED_APPS 的 各 个 功能 说 明 如 下 。 


admin: 内 置 的 后 台 管 理 系统 。 
auth: 内 置 的 用 户 认 证 系统 。 
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contenttypes: 记录 项 目 中 所 有 model 元 数据 (Django 的 ORM 框架 ) 。 
sessions: Session 会 话 功能 ， 用 于 标识 当前 访问 网 站 的 用 户 身份 ， 记 录 相 关 用 
户 信息 。 

messages: 消息 提示 功能 。 

staticfiles: 查找 静态 资源 路 径 。 


配置 静态 资源 需要 了 解 属性 STATIC_URL 和 STATICFILES_DIRS 的 区 别 ， 两 者 
区 别 如 下 。 


STATIC URL 是 必须 配置 的 属性 而 且 属 性 值 不 能 为 空 。 如 果 没 有 配置 
STATICFILES_DIRS， 则 STATIC _URL 只 能 识别 App 里 的 static 静态 资源 文 
件 夹 。 

STATICFILES_DIRS 是 可 选 配置 属性 , 属性 值 为 列表 或 元 组 格式 ,每 个 列表 (元 
组 ) 元 素 代表 一 个 静态 资源 文件 夹 ， 这 些 文件 夹 可 自行 命名 。 

在 浏览 器 上 访问 项 目的 静态 资源 时 ， 无 论 项 目的 静态 资源 文件 夹 是 如 何 命名 
的 ， 在 浏览 器 上 ， 静 态 资源 的 上 级 目录 必须 为 static， 而 static 是 STATIC_ 
URL 的 属性 值 ， 因 为 STATIC_URL 也 是 静态 资源 的 起 始 URL。 


模板 信息 是 以 列表 格式 呈现 的 ， 每 个 元 素 具 有 不 同 的 含义 ， 其 含义 说 明 如 下 。 


BACKEND: 定义 模板 引擎 ， 用 于 识别 模板 里 面 的 变量 和 指令 。 内 置 的 模板 
引擎 有 DjangoTemplates 和 jinja2.Jinja2， 每 个 模板 引擎 都 有 自己 的 变量 和 指令 
语法 。 

DIRS: 设置 模板 所 在 路 径 ， 告 诉 Django 在 哪个 地 方 查找 模板 的 位 置 ， 默 认 
为 空 列 表 。 

APP_DIRS: 是 否 在 App 里 查找 模板 文件 。 

OPTIONS: 用 于 填充 在 RequestContext 中 上 下 文 的 调用 函数 ， 一 般 情 况 下 不 
做 任何 修改 。 


Django 配置 MySQL 数据 库 连 接 信息 : 


DATABASES = { 


'default'"': { 
'ENGINE': '‘'django.db.backends.mysql', 
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'NAME': "django qdb'v 
"USER' : "Toot'v 
"PRSSWORD': '1234"', 
DG 2 人 
PORT3"3306Y, 


} 


中 间 件 由 属性 MIDDLEWARE 完成 配置 ， 属 性 MIDDLEWARE 的 数据 格式 为 列 
表 类 型 ， 每 个 中 间 件 的 设置 顺序 是 固定 的 ， 如果 随意 变更 中 间 件 很 容易 导致 程序 异常 。 
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URL (Uniform Resource Locator， 统 一 资源 定位 符 ) 是 对 可 以 从 互联 网 上 得 到 的 
资源 位 置 和 访问 方法 的 一 种 简洁 的 表示 ， 是 互联 网 上 标准 资源 的 地 址 。 互 联网 上 的 每 
个 文件 都 有 一 个 唯一 的 URL， 用 于 指出 文件 的 路 径 位 置 。 简 单 地 说 ，URL 就 是 常 说 
的 网 址 ， 每 个 地 址 代表 不 同 的 网 页 ， 在 Django 中 ，URL 也 称 为 URLconf。 


3.1 URL 编写 规则 


在 讲解 URL 编写 规则 之 前 ， 需 对 MyDjango 项 目的 目录 进行 调整 ， 使 其 更 符合 
开发 规范 性 。 在 每 个 App 中 设置 独立 的 静态 资源 和 模板 文件 夹 并 添加 一 个 空白 内 容 
的 py 文件 ， 命 为 urls.py。 项 目 结构 如 图 3-1 所 示 。 





第 3 章 编写 URL 规则 


MyDjango EA\MyDjango 
Y Bindex 

> Bamigrations 

> Bstatic 





> Btemplates 
画 _in_py 
艺 adminpy 
篇 apps.py 
访 models.py 
画 testspy 
艺 unspy 
本 views.py 
> ta MyDjango 
> Pauser 
managepy 

















图 3-1 MyDjango 目录 结构 


在 App 里 添加 urlspy 是 将 属于 App 的 URL 都 写 入 到 该 文件 中 ， 而 项 目 根 目录 
的 urlspy 是 将 每 个 App 的 urls.py 统一 管理 。 当 程序 收 到 用 户 请 求 的 时 候 ， 首 先 在 
根 目 录 的 urlspy 查找 该 URL 是 属于 那个 App， 然 后 再 从 App 的 urls.py 找到 具体 的 
URL 信息 。 在 根 目录 的 urls.py 编写 URL 规则 ， 如 下 所 示 : 

















# 根 目录 的 urls .py 
from django.contrib import admin 
from django.urls import path,include 
urlpatterns = [ 
path('admin/', admin.site.urls), 
path('',include('index.urls')) 


] 

上 上述 代码 设 定 了 两 个 URL 地 址 ， 分 别 是 Admin 站 点 管理 和 首页 地 址 。 其 中 
Admin 站 点 管理 是 在 创建 项 目 时 已 自动 生成 ， 一 般 情况 下 无 须 更 改 。urls.py 的 代码 解 
释 如 下 。 











® from django.contrib import admin: 导入 Admin 功能 模块 。 

® from django.urls Import path.include: 导入 URL 编写 模块 。 

e ”urlpatterns: 整个 项 目的 URL 集合 ， 每 个 元 素 代表 一 条 URL 信息 。 

。e path('admin/', admin.site.urls):; ” 设 定 Admin 的 URL。'admin/' 代 表 
127.0.0.1:8000/admin 地 址 信息 ，admin 后 面 的 针 杠 是 路 径 分隔 符 ，admin site. 
urls 是 URL 的 处 理 函 数 ， 也 称 为 视图 函数 。 

epath(' ',include('indexurls')): URL 为 空 ， 代 表 为 网 站 的 域名 ， 即 127.0.0.1:8000， 
通常 是 网 站 的 首页 ; include 将 该 URL 分 发 给 index 的 urlspy 处 理 。 
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由 于 首页 的 地 址 分 发 给 index 的 urls py 处 理 ， 因 此 下 一 步 需要 对 index 的 urls.py 





编写 URL 信息 ， 代 码 如 下 : 


# index 的 urls.pY 
from django .urls import path 
from . import Views 
urlpatterns = [ 

path('', views.index) 














index 的 urlspy 的 编写 规则 与 根 目录 的 urlspy 大 致 相同 ， 基 本 上 所 有 的 URL 都 


是 有 固定 编写 格式 的 。 上 述 代 码 导 入 了 同一 目录 下 的 views.py 文件 ， 该 文件 用 于 编 
写 视图 函数 ， 处 理 URL 请 求 信息 并 返回 网 页 内 容 给 用 户 。 因 此 ， 在 views.py 中 编写 
































index 函数 的 处 理 过 程 ， 代 码 如 下 : 


# index 的 views.py 
from django.http import HttpResponse 
# Create your views here. 
def index(request): 
return HttpResponse ("Hello world") 


index 函数 必须 设置 参数 request， 该 参数 代表 当前 用 户 的 请 求 对 象 ， 该 对 象 包 
含 用 户 名 、 请 求 内 容 和 请 求 方式 等 信息 ， 视 图 函数 执行 完成 后 必须 使 用 return 将 





处 理 结果 返回 ， 否 则 程序 会 抛 出 异常 信息 。 启 动 MyDjango 项 目 ， 在 浏览 器 中 打 
http://127.0.0.1:8000/， 运 行 结果 如 图 3-2 所 示 。 

















€ 3 © [© 127.0.0.1:8000 
Hello world 
图 3-2 首页 内 容 


3.2 带 变量 的 URL 












































在 日 常 开发 过 程 中 ， 有 时 候 一 个 URL 可 以 代表 多 个 不 同 的 页 面 ， 如 编写 带 有 
期 的 URL， 若 根据 前 面 的 编写 方式 ， 按 一 年 计算 ， 则 需要 开发 者 编写 365 个 不 同 
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URL 才能 实现 ， 这 种 做 法 明显 是 不 可 取 的 。 因 此 ，Django 在 编写 URL 时 ， 可 以 对 
URL 设置 变量 值 ， 使 URL 具有 多 样 性 。 

URL 的 变量 类 型 有 字符 类 型 、 整 型 、slug 和 uuid, 最 为 常用 的 是 字符 类 型 和 整 型 。 
各 个 类 型 说 明 如 下 。 


ee 字符 类 型 : 匹配 任何 非 空 字符 串 ， 但 不 含 儿 杠 。 如 果 没有 指定 类 型 ， 默 认 使 
用 该 类 型 。 

e@ 整 型 ， 匹 配 0 和 正 整数 。 

eslug: 可 理解 为 注释 、 后 缓 或 附属 等 概念 ， 常 作为 URL 的 解释 性 字符 。 可 匹 
配 任何 ASCII 字符 以 及 连接 符 和 下 画 线 ， 能 使 URL 更 加 清晰 易 懂 。 比 如 网 页 
的 标题 是 “13 岁 的 孩子 ”， 其 URL 地 址 可 以 设置 为 “13-sui-de-hai-zi”。 

euuid: 匹配 一 个 uuid 格式 的 对 象 。 为 了 防止 冲突 ， 规 定 必须 使 用 破 折 号 并 且 
所 有 字母 必须 小 写 ， 例 如 075194d3-6885-417e-a8a8-6c931e272f00。 


根据 上 述 变 量 类 型 ， 在 index 的 urlspy 里 添加 带 有 字符 类 型 、 整 型 和 slug 的 
URL 地 址 信息 ， 代 码 如 下 : 
# index 的 urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
path('', views.index), 
# 添加 带 有 字符 类 型 、 整 型 和 slug 的 URL 


path('<year>/<int:month>/<slug:day>', views.mydate) 


] 

在 URL 中 使 用 变量 符号 “< >” 可 以 为 URL 设置 变量 。 在 括号 里 面 以 冒号 划 
分 为 两 部 分 ， 前 面 代表 的 是 变量 的 数据 类 型 ， 后 面 代表 的 是 变量 名 ， 变 量 名 可 自行 
命名 。 上 述 代码 对 新 增 的 URL 设置 了 三 个 变量 值 ， 分 别 是 <year>、<int:month> 和 
<slug:day>， 变 量 说 明 如 下 。 

e <year>: 变量 名 为 year， 数 据 格式 为 字符 类 型 ， 与 <str:year> 的 含义 一 样 。 

e ”<int:month>: 变量 名 为 month， 数 据 格 式 为 整 型 。 

e <slug:day>: 变量 名 为 day， 数 据 格式 为 slug。 


然后 在 views.py 中 编写 视图 函数 mydate 的 处 理 方法 ， 代 码 如 下 : 
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# views.py 的 mydate 函数 
def mydate (request, year, month, day): 
return HttpResponse (str(year) +'/'+ str(month) +'/'+ str(day)) 


视图 函数 mydate 有 4 个 函数 参数 ， 其 中 参数 year、month 和 day 来 自 于 URL 的 
变量 。URL 的 变量 和 视图 函数 的 参数 要 一 一 对 应 ， 如 果 视 图 函数 的 参数 与 URL 的 变 
量 对 应 不 上 ， 那 么 程序 会 抛 出 参数 不 相符 的 报错 信息 。 启 动 项 目 ， 在 浏览 器 上 输入 
http://127.0.0.1:8000/2018/05/01， 运 行 结果 如 图 3-3 所 示 。 
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图 3-3 运行 结果 


在 上 述 例 子 中 ，URL 的 变量 分 别 代表 年 、 月 、 日 。 从 变量 的 数据 类 型 可 以 看 出 ， 

变量 值 只 要 符合 数据 格式 都 是 合法 的 ， 使 得 某 些 变量 值 不 符合 日 期 格式 要 求 。 为 了 进 

步 规范 日 期 格式 ， 可 以 使 用 正则 表达 式 限制 URL 的 可 变 范 围 。 正 则 表达 式 的 URL 
编写 规则 如 下 : 






































from django.urls import path, re path 
from . import views 
urlpatterns = [ 
path('', views.index), 
# path('<year>/<int:month>/<slug:day>', views.mydate), 
re_path('(?P<year>[0-9] {4})/(?P<month>[0-9] {2})/(?P<day>[0-9] {2}). 
html', views.mydate) 


在 URL 中 引入 正则 表达 式 ， 首 先导 入 re_path 功能 模块 ， 正 则 表达 式 的 作用 是 
对 URL 的 变量 进行 截取 与 判断 ， 以 小 括号 表示 ， 每 个 小 括号 的 前 后 可 以 使 用 斜 杠 或 
者 其 他 字符 将 其 分 隔 。 以 上 述 代码 为 例 ， 分 别 将 变量 year、month 和 day 以 斜 杠 分 割 ， 
每 个 变量 以 一 个 小 括号 为 单位 ， 在 小 括号 内 ， 可 分 为 三 部 分 ， 以 (?P<year>[0-9]{4)) 
为 例 进 行 介绍 。 



































。 ?P 是 固定 格式 。 
”<year> 为 变量 的 编写 规则 。 
e [0-9]{4} 是 正则 表达 式 的 匹配 模式 ， 代 表 变 量 的 长 度 为 4， 只 允许 取 0-9 的 值 。 
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值得 注意 的 是 ， 如 果 URL 的 末端 使 用 正则 表达 式 ， 那 么 在 该 URL 的 末端 应 加 上 
斜 杠 或 者 其 他 字符 ， 否 则 正则 表达 式 无 法 生效 。 例 如 上 述 例子 的 变量 day， 若 在 末端 
没有 设置 “.html”， 则 在 浏览 器 上 输入 无 限 长 的 字符 串 ， 程 序 也 能 正常 访问 。 


3.3 设置 参数 name 


除了 在 URL 里 面 设置 变量 之 外 ，Django 还 可 以 对 URL 进行 命名 。 在 index 的 
urlspy、views.py 和 模板 myyearhtml 中 添加 以 下 代码 : 





# 在 urls .py 添加 新 的 URL 信息 


re path(' (?P<year>[0-9] {4}) .html', views.myyear, name='myyear') 


# 在 views .py 添加 对 应 的 视图 函数 
def myyear (request, year): 
return render(request, ‘'myyear.html') 


# 在 templates 文件 夹 添加 myyear .html 文件 : 
<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="UTF-8"> 
<title>Title</title> 
</head> 
<body> 
<div><a href="/2018.html">2018 old Archive</a></div> 
<div><a href="{% url 'myyear' 2018 %}">2018 Archive</a></div> 
</body> 
</html> 


上 述 代码 分 别 从 URL、 视 图 函数 和 HTML 模板 来 说 明 参 数 name 的 具体 作用 ， 
整个 执行 流程 如 下 : 
(1) 当 用 户 访问 该 URL 时 ， 项 目 根据 URL 信息 选择 视图 函数 myyear 处 理 ， 并 
将 该 URL 命名 为 myyear。 
(2) 视图 函数 myyear 将 模板 myyearhtml 作为 响应 内 容 并 生成 相应 的 网 页 返回 
给 用 户 。 


(3) 在 模板 myyearhtml 中 分 别 设置 两 个 标签 a， 虽 然 两 个 标签 a 的 href 属性 值 
的 写法 有 所 不 同 ， 但 实质 上 两 者 都 指向 命名 为 myyear 的 URL 地 址 信息 。 
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(4) 第 二 个 标签 a 的 href 为 {% url 'myyear' 2018 %}， 这 是 Django 的 模板 语法 ， 
模板 语法 以 {% %} 表示 。 其 中 ，url 'myyear' 是 将 命名 为 myyear 的 URL 地 址 信息 作 
为 href 属性 值 ，2018 是 该 URL 的 变量 year， 若 URL 没有 设置 变量 值 ， 则 无 须 添加 。 


从 上 述 例子 可 以 看 到 ， 模 板 中 的 myyear 与 urls py 所 设置 的 参数 name 是 一 一 对 
应 的 。 参 数 name 的 作用 是 对 该 URL 地 址 信息 进行 命名 ， 然 后 在 HTML 模板 中 使 用 
可 以 生成 相应 的 URL 信息 。 

在 以 往 ， 大 多 数 开发 者 都 是 采用 第 一 种 方法 在 模板 上 设置 每 个 标签 a 的 href 属性 
值 ， 如 果 URL 地 址 信息 发 生变 更 ， 就 要 修改 每 个 标签 a 的 href 属性 值 ， 这 种 做 法 不 
利于 URL 的 变更 和 维护 。 而 在 URL 中 设置 参数 name， 只 要 参数 name 的 值 不 变 ， 无 
论 URL 地 址 信息 如 何 修改 都 无 须 修改 模板 中 标签 a 的 href 属性 值 。 运 行 结果 如 图 3-4 
所 示 。 























D THe 





3.4 设置 额外 参数 


除了 参数 name 之 外 ， 还 有 一 种 参数 类 型 是 以 字典 的 数据 类 型 传递 的 ， 该 参数 没 
有 具体 命名 ， 只 要 是 字典 形式 即 可 ， 而 且 该 参数 只 能 在 视图 函数 中 读 取 和 使 用 。 其 代 
码 如 下 : 








# 参数 为 字典 的 URL 
re path('dict/(?P<year>[0-9] {4}) .htm', views.myyear dict, {'month': 
'05'}, name='myyear dict') 


# 参数 为 字典 的 URL 的 视图 函数 
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def myyear dict (request, year, month): 
return render(request, ‘myyear dict.html',{"'month':month}) 


# 在 templates 文件 夹 添加 myyear_dict .html 文件 : 
<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="UTF-8"> 
<title>Title</title> 
</head> 
<body> 
<a href="{% url 'myyear dict' 2018 %}">2018 {{ month }} Archive</a> 
</body> 
</html> 


上 述 代码 分 别 从 URL、 视图 函数 和 HTML 模板 来 说 明 URL 额外 参数 的 具体 作用 ， 
说 明 如 下 : 


e 除了 在 URL 地 址 信息 中 设置 参数 name 之 外 ， 还 加 入 了 参数 {'month': 
1'05'}， 该 参数 用 于 设置 参数 month， 参 数值 为 05。 

e。 然后 视图 函数 myyear dict 获取 了 变量 year 和 参数 month， 前 者 设置 在 URL 
地 址 中 ， 而 后 者 在 URL 地 址 外 。 

。 最 后 视图 函数 将 参数 month 的 值 传递 到 HTML 模板 并 生成 HTML 网 页 返回 给 
用 户 。 运 行 结果 如 图 3-5 所 示 。 





| IO 127.0.0.1:8000/dict/2018.htm 





127.0.0.1:8000/dict/2018.htm 





图 3-5 运行 结果 
在 编写 URL 规则 时 ， 如 果 需 要 设置 额外 参数 ， 设 置 规则 如 下 : 
@ 参数 只 能 以 字典 的 形式 表示 。 
e 设置 的 参数 只 能 在 视图 函数 读 取 和 使 用 。 
@。 字典 的 一 个 键 值 对 代表 一 个 参数 ， 键 代表 参数 名 ， 值 代表 参数 值 。 
@ 参数 值 没 有 数据 格式 限制 ， 可 以 为 菜 个 对 象 、 字 符 串 或 列表 (元 组 ) 等 。 
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3.5 本 章 小 结 





统一 资源 定位 符 (Uniform Resource Locator，URL) 是 对 可 以 从 互联 网 上 得 到 的 
资源 位 置 和 访问 方法 的 一 种 简洁 的 表示 ， 是 互联 网 上 标准 资源 的 地 址 。 互 联网 上 的 每 
个 文件 都 有 一 个 唯一 的 URL， 用 于 指出 文件 的 路 径 位 置 。 简 单 地 说 ，URL 就 是 常 说 
的 网 址 ， 每 个 地 址 代表 不 同 的 网 页 ， 在 Django 中 ，URL 也 称 为 URLconf。 


URL 的 基本 编写 规则 如 下 ， 以 根 目录 的 urls.py 为 例 进行 介绍 。 


。 from django.contrib import admin: 导入 Admin 功能 模块 。 

e from django.urls import path,include: 导入 URL 编写 模块 。 

。 urlpatterns: 整个 项 目的 URL 集合 ， 每 个 元 素 代表 一 条 URL 信息 。 

e path('admin/', admin.site.urls): ” 设 定 Admin 的 URL。'admin/' 代 表 
127.0.0.1:8000/admin 地 址 信息 ，admin 后 面 的 儿 杠 是 路 径 分 隔 符 ;，admin.site. 
urls 是 URL 的 处 理 函 数 ， 也 称 为 视图 函数 。 


e path(' ',include('index.urls')):; URL 为 室 ， 代 表 网 站 的 域名 ， 即 127.0.0.1:8000， 
通常 是 网 站 的 首页 ; include 将 该 URL 分 发 给 index 的 urls.py 处 理 。 


URL 的 变量 类 型 有 字符 类 型 、 整 型 、slug 和 uuid， 最 为 常用 的 是 字符 类 型 和 整 型 。 
各 个 类 型 说 明 如 下 。 

。 字符 类 型 : 匹配 任何 非 空 字符 串 ， 但 不 含 针 杠 。 如 果 没 有 指定 类 型 ， 默 认 使 用 
该 类 型 。 

e 整 型 ， 匹 配 0 和 正 整 数 。 

。 slug: 可 理解 为 注释 、 后 缓 或 附属 等 概念 ， 常 作为 URL 的 解释 性 字符 。 可 匹 
配 任何 ASCII 字符 以 及 连接 符 和 下 画 线 ， 能 使 URL 更 加 清晰 易 懂 。 比 如 网 页 
的 标题 是 “13 岁 的 孩子 ”， 其 URL 地 址 可 以 设置 为 “13-sui-de-hai-zi”。 

。 uuid: 匹配 一 个 uuid 格式 的 对 象 。 为 了 防止 冲突 ， 规 定 必须 使 用 破 折 号 并 且 
所 有 字母 必须 小 写 ， 例 如 075194d3-6885-417e-a8a8-6c931e272f00。 


在 URL 中 引入 正则 表达 式 ， 首 先导 入 re_path 功能 模块 ， 正 则 表达 式 的 作用 是 对 
URL 的 变量 进行 截取 与 判断 ， 以 小 括号 表示 ， 每 个 小 括号 的 前 后 可 以 使 用 斜 杠 或 者 其 
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他 字符 将 其 分 隔 。 以 上 述 代 码 为 例 ， 分 别 将 变量 year、month 和 day 以 斜 杠 分 割 ， 每 
个 变量 以 一 个 小 括号 为 单位 , 在 小 括号 内 , 可 分 为 三 部 分 , 以 (?P<year>[0-9]{4}) 为 例 : 
。 2?P 是 固定 格式 。 
@ <year> 为 变量 的 编写 规则 。 
e@ [0-9]{4} 是 正则 表达 式 的 匹配 模式 ， 代 表 变 量 的 长 度 为 4， 只 允许 取 0-9 的 值 。 


值得 注意 的 是 ， 如 果 URL 的 末端 使 用 正则 表达 式 ， 那 么 在 该 URL 的 末端 应 加 上 
斜 杠 或 者 其 他 字符 ， 否 则 正则 表达 式 无 法 生效 。 例 如 上 述 例 子 的 变量 day， 若 在 末端 
没有 设置 “html”， 则 在 浏览 器 上 输入 无 限 长 的 字符 串 ， 程 序 也 能 正常 访问 。 

参数 name 的 作用 是 对 URL 地 址 进行 命名 ， 然 后 在 HIML 模板 中 使 用 可 以 生成 
相应 的 URL 信息 。 在 URL 中 设置 参数 name， 只 要 参数 name 的 值 不 变 ， 无 论 URL 
地 址 信息 如 何 修改 都 无 须 修改 模板 中 标签 a 的 href 属性 值 。 


在 编写 URL 规则 时 ， 如 果 需 要 设置 额外 参数 ， 设 置 规则 如 下 : 


e 参数 只 能 以 字典 的 形式 表示 。 

日 ”设置 的 参数 只 能 在 视图 函数 中 读 取 和 使 用 。 

。 “字典 的 一 个 键 值 对 代表 一 个 参数 ， 键 代表 参数 名 ， 值 代表 参数 值 。 

日 ”参数 值 没有 数据 格式 限制 ， 可 以 为 某 个 对 象 、 字 符 串 或 列表 〔 元 组 ) 等 。 


41 


视图 (View) 是 Django 的 MTV 架构 模式 的 V 部 分 ， 主 要 负责 处 理 用 户 请 求 
和 生成 相应 的 响应 内 容 ， 然 后 在 页 面 或 其 他 类 型 文档 中 显示 。 也 可 以 理解 为 视图 是 
MVC 架构 里 面 的 C 部 分 (控制 器 ) ， 主 要 处 理 功能 和 业务 上 的 逻辑 。 


4.1 构建 网 页 内 容 


在 第 3 章 中 ， 我 们 看 到 视图 函数 都 是 通过 retum 方式 返回 数据 内 容 的 ， 然 后 生成 
相应 的 网 页 内 容 呈 现在 浏览 器 上 。 而 视图 函数 的 retum 具有 多 种 响应 类 型 ， 如 表 4-1 
所 示 。 
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表 4-1 视图 函数 return 的 响应 类 型 
响应 类 型 
TIP 关 太 克 200， 请 求 已 成 功 补 服务 器 和 
TD2， 本 则 Admin 上 UL 
HttpResponsePermanentRedirect("/ uh i 《 
HT 访问 的 页 面 不 存在 或 者 请 求 错 


TIP 状态 码 404， 网 页 不 存在 或 网 页 的 UR 失效 
HTTP 状 态 码 403， 没 有 访问 权限 


0 HTTP 状 态 码 405， 不 允许 使 用 该 请 求 方式 


HTIP 状 态 码 500， 服 务 器 内 容错 误 


响应 类 型 代表 HTTP 状态 码 ， 其 核心 作用 是 Web Server 服务 器 用 来 告诉 客户 端 
当前 的 网 页 请 求 发 生 了 什么 事 ， 或 者 当前 Web 服务 器 的 响应 状态 。 上 述 响 应 主要 来 
自 于 模块 django.http， 该 模块 是 实现 响应 功能 的 核心 。 在 实际 开发 中 ， 可 以 使 用 该 模 
板 实现 文件 下 载 功能 ， 在 index 的 urls.py 和 views.py 中 分 别 添加 以 下 代码 : 





# urls.py 代码 
path('download.html', views.download) 


# views .py 代码 
def download (request): 
response = HttpResponse (content type='text/csv') 


response['Content-Disposition'] = "attachment; filename="somefilename. 
csv"" 
writer = csv.writer (Tesponse) 
writer.writerow(['First row', 'A', 'B', ‘'C']) 
return response 
上 述 文件 下 载 功能 说 明 如 下 : 


e@ ” 当 接 收 到 用 户 的 请 求 后 ， 视 图 函数 download 首先 定义 HttpResponse 的 响应 类 
型 为 文件 (text/csv) 类 型 ， 生 成 response 对 象 。 

@ 然后 在 response 对 象 上 定义 Content-Disposition, 设置 浏览 器 下 载 文件 的 名 称 。 
attachment 设置 文件 的 下 载 方式 ，filename 为 文件 名 。 

e 最 后 使 用 CSV 模块 加 载 response 对 象 ， 把 数据 写 入 response 对 象 所 设置 的 
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CSV 文件 并 将 response 对 象 返回 到 浏览 器 上 ， 从 而 实现 文件 下 载 。 运 行 结果 


如 














图 4-1 所 示 。 
somefilename.csy 
a http://127.0.0.1:8000/download.html 
在 文件 来 中 显示 
图 4-1 文件 下 载 








django.http 除了 实现 文件 下 载 之 外 ， 要 使 用 该 模块 生成 精美 的 HIML 网 页 ， 可 以 
Se 应 内 容 中 编写 HTML 源码 ， 如 HttpResponse('<html><body>...</body></html>')。 

管 这 是 一 种 可 行 的 方法 ， 但 并 不 符合 实际 开发 。 因 此 ，Django 在 django.http 模块 上 
eb 装 ， 从 而 有 了 render0、render to_response() 和 redirect() 函数 。 

render() 和 render to_response() 实现 的 功能 是 一 致 的 。render to response() 自 2.0 
版 本 以 来 已 开始 被 弃 用 ， 并 不 代表 在 2.0 版 本 无 法 使 用 ， 只 是 大 部 分 开发 者 都 使 用 


render()。 

















大 | 




















此 ， 本 书 只 对 render0 进行 讲解 ，render0 的 语法 如 下 : 





render (request, template name, context = None, content type = None, status 
= None, using = None) 


函数 render() 的 参数 request 和 template name 是 必需 参数 , 其 余 的 参数 是 可 选 参数 。 
各 个 参数 说 明 如 下 。 


为 了 更 


所 示 。 
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Trequest; 浏览 器 向 服务 器 发 送 的 请 求 对 象 ， 包 含 用 户 信息 、 请 求 内 容 和 请 求 方 
式 等 。 

template_name: HTML 模板 文件 名 ， 用 于 生成 HIML 网 页 。 

context: 对 HTML 模板 的 变量 赋值 ， 以 字典 格式 表示 ， 默 认 情况 下 是 一 个 空 
字典 。 

content type: 响应 数据 的 数据 格式 ， 一 般 情 况 下 使 用 默认 值 即 可 。 

status: HTTP 状态 码 ， 默 认为 200。 

using: 设置 HTML 模板 转换 生成 HTML 网 页 的 模板 引擎 。 











好 地 说 明 render 使 用 方法 , 将 MyDjango 项 目 整理 归纳 ， 项 目 结构 如 图 4-2 














第 4 章 探究 视 医 








~ WMyDjango =WW92092 
~ Blindex 
> Bl migrations 
~ Pstatic 
> Bcss 
> Hlimg 
> mjs 
~ Dtemplates 
襄 indexhtml 
画 _int_py 
艺 adminpy 
亏 appspy 
遍 modslspy 
局 testspy 
局 urspy 
局 views.py 
> Bi MyDjango 


4-2 项 目 结构 











项 目的 templates 有 index.html 模板 ， 这 是 一 个 伪 华 为 商城 的 网 页 ，static 用 于 存 
放 该 HTML 模板 的 静态 资源 。 我 们 在 urls.py 和 views.py 中 编写 以 下 代码 : 


# urls.py 代码 如 下 : 
from django.urls import path 
from . import views 
urlpatterns = [ 

# 首页 的 URL 

path('', views.index), 


] 


# views .py 代码 如 下 : 
from django.shortcuts import render 
def index(request): 
return render(request, 'index.html' ,context={'title': ' 首页 '}， 
status=500) 


从 视图 函数 的 context={'title': ' 首页 '} 可 知 ， 将 index.html 模板 变量 title 的 值 
设 为 首页 ， 返 回 的 状态 码 为 500。 启 动 项 目 ， 运 行 结果 如 图 4-3 所 示 。 








图 4-3 运行 结果 
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除了 render 函数 外 ， 还 有 redirect0 函数 。redirect0 函数 用 于 实现 请 求 重 定向 ， 
重 定向 的 链接 以 字符 串 的 形式 表示 ， 链 接 的 地 址 信息 可 以 支持 相对 路 径 和 绝对 路 径 ， 
代码 如 下 : 








# urls.py 的 URL 地 址 信息 


path('login.html', views.login) 


# views .py 的 视图 函数 
def login (request) : 
# 相对 路 径 ， 代 表 首 页 地 址 
return redirect('/') 
# 绝对 路 径 ， 完 整 的 地 址 信息 
# return redirect('http://127.0.0.1:8000/') 


启动 项 目 ， 运 行 结果 如 图 4-4 所 示 。 


€ 了 QI101270018000 


oem rm 





图 4-4 运行 结果 


4.2 数据 可 视 化 








视图 除了 接收 用 户 请 求 和 返回 响应 内 容 之 外 ， 还 可 以 与 模型 (Model) 实现 数据 
交互 (操作 数据 库 ) 。 视 图 相当 于 一 个 处 理 中 心 ， 负 责 接收 用 户 请 求 ， 然 后 根据 请 求 
信息 读 取 并 处 理 后 台数 据 ， 最 后 生成 HIML 网 页 返回 给 用 户 。 

视图 操作 数据 库 实质 是 从 modelspy 导入 数据 库 映射 对 象 ，models.py 的 数据 库 对 
象 是 通过 Django 内 置 的 ORM 框架 构建 数据 库 映 射 的 ， 从 而 生成 数据 库 对 象 〈 数 据 库 
对 象 的 实现 过 程 会 在 第 6 章 讲解 ) 。 我 们 在 index 的 models.py 中 编写 以 下 代码 : 







































































# models.py 

from dijango.db import models 

# Create your models here. 

class Product (models.Model): 
id = models.IntegerField(primary key=True) 
name = models.CharField (max length=50) 
type = models.CharField (max length=20) 


上 述 代码 将 Product 类 和 数据 表 Product 构成 映射 关系 ， 代 码 只 是 搭建 两 者 的 关 
系 ， 在 数据 库 中 并 没有 生成 相应 的 数据 表 。 我 们 在 CMD 窗口 中 使 用 python manage. 
py XXX 指令 通过 Product 类 创建 数据 表 Product， 创 建 指令 如 下 : 

















# 根据 models .py 生成 相关 的 .py 文件 ， 该 文件 用 于 创建 数据 表 
E:\MyDjango>python manage.py makemigrations 
Migrations for "index': 
index\migrations\0001 initial.py 
- Create model product 
# 创建 数据 表 
E:\MyDjango>python manage.py migrate 


指令 执行 完成 后 ， 在 数据 库 中 可 以 看 到 新 创建 的 数据 表 ， 如 图 4-5 所 示 。 





国 auth lL_group 

围 auth_group_permissions 
围 auth_permission 

围 auth_user 

围 auth_user groups 
auth_user_user_permissions 
围 django_admin log 

围 django_content type 

围 django_migrations 
django_session 

围 index_product 


图 4-5 创建 数据 表 























从 图 4-5 中 可 以 看 到 ， 当 指令 执行 完成 后 ，Django 会 默认 创建 多 个 数据 表 ， 其 中 
数据 表 index_product 对 应 index 的 models.py 所 定义 的 Product 类 ， 其 余 的 数据 表 都 是 
Django 内 置 的 功能 所 生成 的 ， 主 要 用 于 Admin 站 点 、 用 户 认 证 和 Session 会 话 等 功能 。 
在 数据 表 index_ product 中 添加 如 图 4-6 所 示 的 数据 。 
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本 一 到 国 index_product @mydjango .… 
三 ”第 开 吉 和 国 备 E -和 洁 E 版 
id name bype 
， 国 天 == 手机 

2 由 玩 手机 

3 4 为 拖 机 

4 Mate/P 系 列 手机 

5 于 本 电 及 干杯 8E 功 

6 手 环 GG 芝 

7 手 过 干 板 8 从 功 

8 了 机 通用 配件 

9 童生 通用 配件 

10 移动 电源 通用 配件 














图 4-6 在 index_product 中 添加 数据 


完成 数据 表 的 数据 添加 后 ， 接 着 将 数据 表 的 数据 展现 在 网 页 上 。 首 先 将 模板 文件 
index.html 左 侧 导 航 栏 的 代码 注释 掉 ， 然 后 在 同一 位 置 添加 Django 的 模板 语法 ， 代 码 
如 下 : 


# 注释 代码 

{# <ul id="cate box" class="]1f">#} 

{# <1i>#} 

{# <h3><a href="#"> 手 机 </a></h3>#} 

{# <p><span> 荣耀 </span><span> 畅 玩 </span><span> 华为 </ 
span><span>Mate/P 系列 </span></p>#} 

{# </1i>#} 

{# <1i>#} 

{# <h3><a href="#"> 平 板 & 穿戴 </a></h3>#} 

{# <p><span> 平板 电脑 </span><span> 手 环 </span><span> 手表 </ 
span></p>#} 

{# </1i>#} 


{# </ul>#} 


# 添加 新 的 代码 
<ul id="cate box" class="]lf"> 
{% for type in type list %} 
<1i> 
<h3><a href="#">{{ type.type }}</a></h3> 
<p> 
{% for name in name list %} 
{g% if name.type == type.type %} 
<span>{{ name.name }}</span> 
{g% endif %} 
{$$ endfor $} 
</p> 
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</1i> 
{$$ endfor %} 
</ul> 


新 添加 的 代码 是 Django 的 模板 语法 ， 主 要 将 视图 的 变量 传递 给 模板 ， 通 过 模板 
引擎 转换 成 HIML 语言 。 上 述 代 码 使 用 循环 和 判断 语句 对 变量 进行 分 析 处 理 ， 具 体 
的 模板 语法 会 在 后 续 的 章节 中 讲解 。 最 后 在 视图 函数 中 编写 代码 ， 将 数据 表 的 数据 与 
模板 连接 起 来 ， 实 现 数 据 可 视 化 ， 代 码 如 下 : 

















# views.py 
def index(request): 
type_list = Product.objects.values('type') .distinct() 
name_ list = Product.objects.values('name','type') 
context = {'title': ' 首 页 '，'type list': type list, 'name list': 
name list} 
return render(request, 'index.html',context=context, status=200) 


上 述 代 码 中 ， 视 图 函数 index 的 处 理 流程 如 下 : 











{01 type_list 用 于 查询 数据 表 字段 type 的 数据 并 将 数据 去 重 ，name _list 用 于 查询 数 
据 表 字段 type 和 name 的 全 部 数据 ， 这 两 种 独特 的 查询 方式 都 是 由 Django 内 置 
的 ORM 框架 提供 的 。 

2 将 查询 所 得 的 数据 以 字典 的 数据 格式 写 入 变量 context 中 ， 变 量 context 是 
render() 函数 的 参数 值 ， 其 作用 是 将 变量 传递 给 HTML 模板 。 

人 3 当 HTML 模板 接收 到 变量 type_list 和 name list 后， 模板 引 擎 解析 模板 语法 并 生 
成 HTML 文件 。 运 行 结果 如 图 4-7 所 示 。 
























































h3 














€ C |© 127.00.1:8000 


华为 官网 。 华为 守 理 


VMALL énm 


某 碳 畅 玩 华为 Mate/P 系 列 


平板 议 穿 戴 
手 株 时 菇 手球 手 雪 


通用 配件 
可 机 言 箱 移动 电源 














图 4-7 运行 结果 
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从 上 述 例 子 可 以 看 到 ， 如 果 想 要 将 数据 库 的 数据 展现 在 网 页 上 ， 需 要 由 视图 、 
模型 和 模板 共同 实现 ， 实 现 步骤 如 下 : 


人 ET) 定义 数据 模型 ， 以 类 的 方式 定义 数据 表 的 字段 。 在 数据 库 创建 数据 表 时 ， 数 据 表 
由 模型 定义 的 类 生成 。 

人 2 在 视图 导入 模型 所 定义 的 类 ， 该 类 也 称 为 数据 表 对 象 ，Django 为 数据 表 对 象 提供 
独 有 的 数据 操作 方法 ， 可 以 实现 数据 库 操作 ， 从 而 获取 数据 表 的 数据 。 


人 3 视图 函数 获取 数据 后 ， 将 数据 以 字典 、 列 表 或 对 象 的 方式 传递 给 HTML 模板 ， 并 
由 模板 引擎 接收 和 解析 ， 最 后 生成 相应 的 HTML 网 页 。 








在 上 述 视 图 函数 中 ， 变 量 context 是 以 字典 的 形式 传递 给 HTML 
模板 的 。 在 实际 开发 过 程 中 ， 如 果 传 递 的 变量 过 多 ， 使 用 变量 
context 时 就 显得 非常 宛 余 ,而 且 不 利于 日 后 的 维护 和 更 新 。 因 此 ， 
使 用 locals() 取代 变量 context， 代 码 如 下 : 
# views.py 
def index(request): 

type_list = Product.objects.values('type').distinct () 


name list = Product.objects.values('name','type') 


title = ' 首页 ' 


return render(request, '‘'index.html',context=locals(), 
status=200) 
locals() 的 使 用 方法 : 在 视图 函数 中 所 定义 的 变量 名 一 定 要 与 
HTML 模板 的 变量 名 相同 才能 生效 ， 如 视图 函数 的 type_list 与 
HTML 模板 的 type list， 两 者 的 变量 名 一 致 才 能 将 视图 函数 的 变 
量 传递 给 HTML 模板 。 





4.3 获取 请 求 信 息 


我 们 知道 视图 是 用 于 接收 并 处 理 用 户 的 请 求 信息 ， 请 求 信息 存放 在 视图 函数 的 
参数 request 中 。 为 了 进一步 了 解 参数 request 的 属性 ， 在 PyCharm 中 使 用 debug 模式 
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启动 项 目 , 并 在 视图 函数 中 设置 断 点 功能 , 然后 查看 request 对 象 的 全 部 属性 , 如 图 4-8 
所 示 。 





区 一 ] 





Mrs ResoverMatch anesindec news nden orgs= 0 kwergs=lL wrl nome=None. app names=l] nemespaces=D 
jangocomtri sessions backende db.SessionStore object al 0x0000008FED74DO48> 


lons vi Lsdjange ere fles plondhandler MemoryFieUploedHander oject ot yx0000008EEDT7BFD0-， <django.core les Viev 
» uter " Sin AnonymousUser hnemymeusueer 


4-8 参数 request 的 属性 











从 图 4-8 中 可 以 看 到 参数 request 的 属性 ， 这 代表 用 户 的 请 求 信息 。 我 们 讲解 一 
些 开 发 过 程 中 常用 的 属性 ， 如 表 4-2 所 示 。 


表 4-2 request 的 常用 属性 
实例 

COOKIES | 获取 客户 端 (浏览 器 ) Cookie 信 息 data = request.COOKIES 
字典 对 象 ， 包 含 所 有 的 上 载 文 件 。 该 字典 
有 三 个 键 : filename 为 上 传 文件 的 文件 名 ; 


content-type 为 上 传 文件 的 类 型 ，content 为 上 
传 文件 的 原始 内 容 


GET 获取 GET 请 求 的 请 求 参数 ， 以 字典 形式 存储 


file = request.FILES 





// 如 {fname': 'TOM'} 




















Trequest.GET.get(‘name') 
// 获 取 客 户 端 的 人 P 地 址 
META 获取 客户 端的 请 求 头 信息 ， 以 字典 形式 存储 request.META .get(REMOTE_ 
ADDR') 
posT 获取 POST 请 求 的 请 求 参数 ， 以 字典 形式 存储 | /如 fname' TOM)  ， 
request.POST.get(‘name') 
method 获取 该 请 求 的 请 求 方式 (GET 或 POST 请 求 ) data = request.method 
path 获取 当前 请 求 的 URL 地 址 path = request.path 
liser 获取 当前 请 求 的 用 户 信息 Ueda 





name= Tequest.user.username 
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上 述 属 性 中 的 GET、POST 和 method 是 每 个 Web 开发 人 员 必 须 掌握 的 基本 属性 ， 
属性 GET 和 POST 用 于 获取 用 户 的 请 求 参数 ， 属 性 method 用 于 获取 用 户 的 请 求 方式 。 
以 视图 函数 login 为 例 ， 代 入 如 下 : 


# urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
path('login.html', views.1login), 
] 


# views.py 
def login (request): 
if request.method == 'POST': 
name = request.POST.get('name') 
# 绝对 路 径 ， 完 整 的 地 址 信息 
# return redirect('http://127.0.0.1:8000/') 
# 相对 路 径 ， 代 表 首 页 地 址 
return redirect('/') 
else: 
if request.GET.get('name') : 
name = request.GET.get ('name') 
else: 
name = 'Everyone' 
return HttpResponse('username is '+ name) 


视图 函数 login 分 别 使 用 了 属性 GET、POST 和 method， 说 明 如 下 : 

@ 首先 使 用 method 对 用 户 的 请 求 方式 进行 判断 ， 一 般 情 况 下 ， 用 户 打开 浏览 器 
访问 某 个 URL 地 址 都 是 GET 请 求 ; 而 在 网 页 上 输入 信息 并 点 击 某 个 按钮 时 ， 
以 POST 请 求 居多 ， 如 用 户 登 录 、 注 册 等 。 

ee 车 判断 请 求 方式 为 POST (GET) ， 则 通过 属性 POST (GET) 来 获取 用 户 提 
交 的 请 求 参 数 。 不 同 的 请 求 方式 需要 使 用 不 同 的 属性 来 获取 用 户 提交 的 请 求 
参数 。 


在 浏览 器 上 分 别 输入 以 下 URL 地 址 : 


http://127.0.0.1:8000/lo0gin.html 
http://127.0.0.1:8000/login.html ?name=Tom 


第 二 条 URL 地 址 多 出 了 ?name=Tom， 这 是 GET 请 求 的 请 求 参 数 。GET 请 求 参 
数 以 ? 为 标识 ， 请 求 参数 以 等 值 的 形式 表示 ， 等 号 前 面 的 是 参数 名 ， 后 面 的 是 参数 值 ， 
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如 果 涉 及 多 个 参数 ， 每 个 参数 之 间 用 & 拼接 。 运 行 结果 如 图 4-9 所 示 。 











€ GC | © 127.0.0.1:8000/login.html 





Username is Everyone 


D 127.0.0.1:8000/loginht x 





* G [© 12700.18000/login htmlzname=Tom 


username is Tom 

















图 4-9 运行 结果 


4.4 通用 视图 
Web 开发 是 一 项 无 聊 而 且 单调 的 工作 ， 特 别 是 在 视图 编写 功能 方面 更 为 显著 。 
为 了 减少 这 类 痛苦 ，Django 植 入 了 通用 视图 这 一 功能 ， 该 功能 封装 了 视图 开发 常用 
的 代码 和 模式 ， 可 以 在 无 须 编写 大 量 代 码 的 情况 下 ， 快 速 完成 数据 视图 的 开发 。 
通用 视图 是 通过 定义 和 声明 类 的 形式 实现 的 ， 根 据 用 途 划 分 三 大 类 : 
TemplateView、ListView 和 DetailView。 三 者 说 明 如 下 : 








。 TemplateView 直接 返回 HTML 模板 ， 但 无 法 将 数据 库 的 数据 展示 出 来 。 

e ListView 能 将 数据 库 的 数据 传递 给 HTML 模板 ， 通 常 获取 某 个 表 的 所 有 数据 。 

e。 DetailView 能 将 数据 库 的 数据 传递 给 HTML 模板 ， 通 常 获取 数据 表 的 单条 数 
据 。 


根据 4.2 节 实 现 的 功能 ， 我 们 将 其 视图 函数 改 用 ListView 实现 。 本 例子 沿用 
index.html 模板 文件 ， 然 后 在 urls.py 中 添加 URL 地 址 信息 ， 代 码 如 下 : 


# views.py 代码 
from django.urls import path 
from . import views 
urlpatterns = [ 

# 通用 视图 ListView 


path('index/', views.ProductList. as_View()) 
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如 果 URL 所 指向 的 处 理 程序 是 由 通用 视图 执行 的 ， 那 么 在 编写 URL 时 ，URL 
所 指向 的 处 理 程 序 应 当 是 一 个 通用 视图 ， 并且 该 通用 视图 上 必须 使 用 as_view0 方法 。 
因为 通用 视图 实质 上 是 一 个 类 ， 使 用 as_view0 方法 相当 于 对 类 进行 实例 化 并 由 类 方 
法 as_view0 执行 处 理 。 最 后 在 views.py 中 编写 通用 视图 ProductList 的 代码 , 代码 如 下 : 

# 通用 视图 

from django.views.generic import ListView 


class ProductList (ListView) : 


# context object name 设置 HTML 模板 的 变量 名 称 


context object name = 'type list' 
# 设 定 HTML 模板 

template name='index view.html' 

# 查询 数据 


queryset = Product.objects.values('type') .distinct() 


# 重 写 get_queryset 方法 ， 对 模型 product 进行 数据 筛选 
# def get queryset (self): 


# type_ list = Product.objects.values('type') .distinct() 
# return type list 
# 添加 其 他 变量 


def get context datal(self, **kwargs): 
context = super().get context data(**kwargs) 
context['name list'] = Product.objects.values('name','type') 
return context 


通用 视图 ProductList 的 代码 说 明 如 下 : 


e 定义 ProductList 类 ， 该 类 继承 自 ListView 类 ， 具 有 ListView 的 所 有 特性 。 

e ”context_object_ name 设置 HTML 模板 的 变量 。 

etemplate name 设置 HTML 模板 。 

@ ”queryset 查询 数据 库 数据 ,查询 结果 会 赋值 给 context object name 所 设置 的 变量 。 
@。 重 写 函 数 get_queryset， 该 函数 的 功能 与 queryset 实现 的 功能 一 致 。 

@ 重 写 函数 get_context data， 该 函数 设置 HTML 模板 的 其 他 变量 。 


通用 视图 的 代码 编写 规则 有 一 定 的 固定 格式 ， 根 据 这 个 固定 格式 可 以 快速 开发 数 
据 视 图 。 除 此 之 外 ， 通 用 视图 还 可 以 获取 URL 的 参数 和 请 求 信息 ， 使 得 通用 视图 更 
加 灵活 ， 以 get_queryset 函数 为 例 : 


# urls.py 
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path('index/<id>.html', views.ProductList.as view(), {'name':'phone'}) 


# 通用 视图 ProductList 类 
def get queryset (self): 


# 获取 URL 的 变量 id 

print (self.kwargs['"'id']) 

# 获取 URL 的 参数 name 

print (self.kwargs['name']) 

# 获取 请 求 方式 

print (seLf.request.method) 

tyYpe_1list = Product.objects.values ('type') .distinct() 
return type list 











上 述 代 码 演示 了 如 何在 通用 视图 中 获取 URL 的 参数 变量 和 用 户 的 请 求 信息 ， 代 
码 说 明 如 下 : 








首先 对 URL 设置 变量 id 和 参数 name， 这 两 种 设置 方式 都 是 日 常 开发 中 经 常 
使 用 的 。 

通用 视图 在 处 理 用 户 请 求 时 ，URL 的 变量 和 参数 都 会 存放 在 通用 视图 的 属性 
kwargs 中 ， 因 此 使 用 selfkwargs['xxx'] 可 以 获取 变量 值 或 参数 值 ，xxx 代表 
变量 (参数 ) 名 。 

要 获取 用 户 请 求 信息 ， 可 以 从 属性 selfrequest 中 获取 。selfrequest 和 视图 函 
数 的 参数 request 的 使 用 方法 是 一 致 的 。 运 行 结 果 如 图 4-10 所 示 。 





Starting development server at http://127.0.0.1:8000/ 
Quit the server with CTRL-BREAK. 


2:57] “GET /index/2.html HTTP/1.1”200 10373 
[09/Apr/2018 16:32:57] “GET /static/img/p9. jpe HITP/1,1”404 1654 
[09/Apr/2018 16:32:57] “GBT /static/img/hw.ico HITP/1.1”200 2498 
pydev debugger: process 3560 is connecting 
















图 4-10 运行 结果 











从 上 面 的 例子 可 以 看 出 ， 通 用 视图 的 代码 量 感觉 比 视图 函数 多 ， 但 是 通用 视图 是 
可 以 被 继承 的 。 假 如 已 经 写 好 了 一 个 基于 类 的 通用 视图 ， 若 要 对 其 添加 拓展 功能 ， 只 
需 继承 原本 这 个 类 即 可 。 如 果 写 的 是 视图 函数 ， 其 拓展 性 就 没有 那么 灵活 ， 可 能 需要 
使 用 装饰 器 等 高 级 技巧 ， 或 者 重新 编写 新 的 视图 函数 ， 而 且 新 函数 的 部 分 代码 与 原本 
函数 的 代码 相同 。 
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4.5 本 章 小 结 

视图 是 Django 的 MTV 架构 模式 的 V 部 分 ， 主 要 负责 处 理 用 户 请 求 和 生成 相应 
的 响应 内 容 ， 然 后 在 页 面 或 其 他 类 型 文档 中 显示 。 也 可 以 理解 为 视图 是 MVC 架构 里 
面 的 C 部 分 (控制 器 ) ， 主 要 处 理 功 能 和 业务 上 的 逻辑 。 

视图 函数 完成 请 求 处 理 后 ， 必 须 通过 retum 方式 返回 数据 内 容 给 用 户 ， 常 用 的 
返回 方式 由 render()、render to_response() 和 redirect() 函数 实现 。 其 中 ，render() 和 
render to_response() 实现 的 功能 是 一 致 的 。render to_response0 自 2.0 版 本 以 来 已 开 
始 被 弃 用 ， 并 不 代表 在 2.0 版 本 无 法 使 用 ， 只 是 大 部 分 开发 者 都 使 用 render()。 

render() 的 参数 request 和 template_name 是 必需 参数 ， 其 余 的 参数 是 可 选 参数 。 
参数 说 明 如 下 。 





erequest: 浏览 器 向 服务 器 发 送 的 请 求 对 象 ， 包 含 用 户 信息 、 请 求 内 容 和 请 求 

etemplate name: HTML 模板 文件 名 ， 用 于 生成 HIML 网 页 。 

日 context: 对 HTML 模板 的 变量 赋值 ， 以 字典 格式 表示 ， 默 认 情 况 下 是 一 个 空 
字典 。 

e content type: 响应 数据 的 数据 格式 ， 一 般 情 况 下 使 用 默认 值 即 可 。 

estatus: HTTP 状态 码 ， 默 认为 200。 

。 using: 设置 HTML 模板 转换 生成 HIML 网 页 的 模板 引擎。 


如 果 想 要 将 数据 库 的 数据 展现 在 网 页 上 ， 需 要 由 视图 、 模 型 和 模板 共同 实现 ， 
实现 步骤 如 下 : 


I01 定义 数据 模型 ， 以 类 的 方式 定义 数据 表 的 字段 。 在 数据 库 创建 数据 表 时 ， 数 据 表 
由 模型 中 定义 的 类 生成 。 


I02 在 视图 中 导入 模型 所 定义 的 类 ， 该 类 也 称 为 数据 表 对 象 ，Django 为 数据 表 对 象 提 
供 独 有 的 数据 操作 方法 ， 可 以 实现 数据 库 操作 ， 从 而 获取 数据 表 的 数据 。 


CET63 视图 函数 获取 数据 后 ， 将 数据 以 字典 、 列 表 或 对 象 的 方式 传递 给 HTML 模板 ， 并 
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由 模板 引擎 接收 和 解析 ， 最 后 生成 相应 的 HTML 网 页 。 











用 户 的 请 求 信息 都 存放 在 视图 函数 的 参数 request 中 ， 其 中 属性 GET、POST 和 
method 是 每 个 Web 开发 人 员 必 须 掌握 的 基本 属性 ， 属 性 GET 和 POST 用 于 获取 用 户 
的 请 求 参数 ， 属 性 method 用 于 获取 用 户 的 请 求 方式 。 

通用 视图 是 通过 定义 和 声明 类 的 形式 实现 的 ， 根 据 用 途 划 分 三 大 类 : 
TemplateView、ListView 和 DetailView。 三 者 说 明 如 下 : 


。 TemplateView 直接 返回 HTML 模板 ， 但 无 法 将 数据 库 的 数据 展示 出 来 。 
e ListView 能 将 数据 库 的 数据 传递 给 HTML 模板 ,通常 获取 某 个 表 的 所 有 数据 。 
。 DetailView 能 将 数据 库 的 数据 传递 给 HTML 模板 ,通常 获取 数据 表 的 单条 数据 。 
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Django 作为 Web 框架 ， 需 要 一 种 很 便利 的 方法 去 动态 地 生成 HIML 网 页 ， 因 此 
有 了 模板 这 个 概念 。 模 板 包 含 所 需 HIML 的 部 分 代码 以 及 一 些 特殊 的 语法 ， 特 殊 的 
语法 用 于 描述 如 何 将 数据 动态 插入 HTML 网 页 中 。 

Django 可 以 配置 一 个 或 多 个 模板 引擎 〈 甚 至 是 0， 如 果 不 需 要 使 用 模板 ) ， 模 板 
系统 有 Django 模板 语言 (Django Template Language，DTL) 和 Jinja2。Diango 模板 
语言 是 Django 内 置 的 模板 语言 ，Jinja2 是 当前 Python 最 流行 的 模板 语言 。 本 书 主要 
以 Django 内 置 的 模板 语言 为 讲述 内 容 ， 模 板 配 置 可 在 2.3 节 查 看 。 


5.1 变量 与 标签 
变量 是 模板 中 最 基本 的 组 成 单位 ， 模 板 变量 是 由 视图 函数 生成 的 。 如 果 变量 没有 
被 视图 函数 生成 , 那么 模板 引擎 解析 HTML 时 ,模板 变量 不 会 显示 在 网 页 上 , 变量 以 {{ 
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variable }} 表示 ，variable 是 变量 名 ， 变 量 的 类 型 可 以 是 Python 支持 的 数据 类 型 ， 使 
用 方法 如 下 : 


# variable 为 字符 串 类 型 或 整 型 ， 如 variable = "Python" 
{{ variable }} 
# 输出 Python 


# variable 为 字典 或 数据 对 象 ， 通 过 点 号 〈.- ) 来 访问 其 属性 值 

# 如 variable = {"name": "Lily", "info": {"home": "BeiJing", "homeplace": 
"ShangHai"}} 

{{ variable.name }} 

# 输出 Lily 

{{ variable.info.home}} 

# 输出 BeiJing 


以 MyDjango 为 例 ， 抽 取 模 板 index.html 的 部 分 代码 ， 代 码 如 下 : 


<head> 
<title>{{ title }}</title> 
<meta charset="utf-8"> 
{% load staticfiles %} 
<link rel="stylesheet" type="text/css" href="{% static "css/hw_index. 
css” Si” > 
<link rel="icon" href="{% static "img/hw.ico" $%}"> 
<script src="{% static "js/hw_ index.js" %}"></script> 
</head> 


<ul id="cate box" class="]lf"> 
{% for type in type list %} 


<1li> 
<h3><a href="#">{{ type.type }}</a></h3> 
<p> 
{% for name in name list %} 
{g% if name .type == type.type %} 
<span>{{ name .name }}</span> 
{% endif %} 
{$$ endfor %} 
</p> 
</1i> 
{$$ endfor 要 } 
</ul> 


上 述 代码 分 别 使 用 模板 的 变量 和 标签 ， 代 码 说 明 如 下 : 


。  {{ title }} 代表 模板 变量 ， 从 变量 名 title 可 以 知道 ， 变 量 的 数据 类 型 是 字符 串 
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ee {o% load staticfiles %} 是 模板 的 内 置 标签 ，load 标签 用 于 导入 静态 资源 信息 。 
®  {% static "css/hw_index.css" %} 是 模板 是 内 置 标签 ，static 标签 用 于 读 取 静 态 资 
源 的 文件 内 容 。 

e  {%fortypeintype list%} 是 for 遍历 标签 ， 将 变量 进行 遍历 输出 。 

。 {% ifnametype 一 typetype %} 是 让 判断 标签 ， 主 要 对 变量 进行 判断 处 理 。 

。 {{typetype }} 代表 变量 type list 的 某 个 属性 。 

从 上 面 的 例子 可 以 看 到 ， 模 板 的 变量 需要 和 标签 相互 结合 使 用 。 模 板 的 标签 就 如 
Python 里 面 的 函数 和 方法 ，Django 常用 的 内 置 标签 说 明 如 表 5-1 所 示 


表 5-2 Django 常 用 内 置 标签 


描述 

遍历 输出 变量 的 内 容 ， 变 量 类 型 应 为 列表 或 数据 对 象 
对 变量 进行 条 件 判断 

生成 csrf token 的 标签 ， 用 于 防护 跨 站 请 求 伪造 攻击 
引用 路 由 配置 的 地 址 ， 生 成 相应 的 URL 地 址 

将 变量 名 重新 命名 

加 载 导 入 Diango 的 标签 库 

读 取 静态 资源 的 文件 内 容 

模板 继承 ，xxx 为 模板 文件 名 ， 使 当前 模板 继承 xxx 模 板 
{% block xxx %} 重 写 父 类 模板 的 代码 





在 上 述 常 用 标签 中 ， 每 个 标签 的 使 用 方法 都 是 各 不 相同 的 。 我 们 通过 简单 的 例子 
来 进一步 了 解 标签 的 使 用 方法 ， 代 码 如 下 : 
# for 标签 支持 嵌 套 ， myList 可 以 是 列表 或 某 个 对 象 


# item 可 自 定义 命名 ，{% endfor 名 } 代表 循环 区 域 终止 符 ， 代 表 这 个 区 域 的 代码 由 标签 for 循 
输出 





当 


$$ for item in myList %} 
{ item }} 
$$ endfor %} 


# i 标签 ,支持 嵌 套 判断 条 件 符 必须 与 变量 之 间 使 用 空格 隔 开 ， 否 则 程序 会 抛 出 异常 
# {g% endif %]} 与 {% endfor %} 的 作用 是 相同 的 


{% if name = "Lily" $%} 
{ name }} 
{ elif name = "Lucy" %} 
{ name }} 
{ else %} 





name }} 
{% endif %} 
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# url 标签 

# 生成 不 带 变量 的 URL 地 址 

# 相关 的 路 由 地 址 : path (''，views.index, name='index') 

# 字符 串 index 是 URL 的 参数 name 的 值 

<a href="{% Url 'index' $}"” target=" blank"> 首 页 </a> 

# 生成 带 变 量 的 URL 地 址 

# 相关 的 路 由 地 址 : path ('search/<int:page>.html', views.search, 
name="'search') 

# 字符 串 search 是 URL 的 参数 name 的 值 ，1 是 URL 的 变量 page 的 值 

<a href="{% url 'search' 1 %}" target=" blank"> 第 1 页 </a> 


# total 标签 

{% with total = products total %} 
{{ total }} 

{% endwith %} 


# load 标签 ， 导 入 静态 文件 标签 库 staticfiles，staticfiles 来 自 settings.py 的 
INSTALLED APPS 
{% load staticfiles %} 


# static 标签 ， 来 自 静态 文件 标签 库 staticfiles 


{% static "css/hw_index.css" %} 


在 for 标签 中 ， 模 板 还 提供 一 些 特殊 的 变量 来 获取 for 标签 的 循环 信息 ， 变 量 说 
明 如 表 5-2 所 示 。 


表 5-2 for 标 签 模板 变量 说 明 
获取 当前 循环 的 索引 ， 从 1 开始 计算 
获取 当前 循环 的 索引 ， 从 0 开始 计算 


索引 从 最 大 数 开始 递减 ， 直 到 索引 到 1 位 置 


forloop.revcounter0 索引 从 最 大 数 开始 递减 ， 直 到 索引 到 0 位 置 

forloop first 当 遍 历 的 元 素 为 第 一 项 时 为 真 

forloop.last 当 遍 历 的 元 素 为 最 后 一 项 时 为 真 
forloop.parentloop 在 嵌 套 的 for 循环 中 ， 获 取 上 层 for 循环 的 forloop 














上 述 变 量 来 自 于 forloop 对 象 ， 该 对 象 是 模板 引擎 解析 for 标签 时 所 生成 的 。 我 
们 通过 简单 的 例子 来 进一步 了 解 forloop 的 使 用 ， 例 子 如 下 : 

{$$ for name in name list %} 

{$$ if forloop.counter == 1 %} 


<span> 这 是 第 一 次 循环 </span> 
{g elif forloop.last %} 
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<span> 这 是 最 后 一 次 循环 </span> 
{$$ else $} 

<span> 本 次 循环 次 数 为 : {{ forloop.counter }}</span> 
{% endif %} 
{$$ endfor 多 } 


5.2 模板 继承 


模板 继承 是 通过 模板 标签 来 实现 的 ， 其 作用 是 将 多 个 HTML 模板 的 共同 代码 集 
中 在 一 个 新 的 HTML 模板 中 ， 然 后 各 个 模板 可 以 直接 调用 新 的 HTML 模板 ， 从 而 生 
成 HTML 网 页 ， 这 样 可 以 减少 模板 之 间 重 复 的 代码 。 其 代码 如 下 : 





<!DOCTYPE html> 
<html> 
<head> 
<meta charset="UTF-8"> 
<title>{{ title }}</title> 
</head> 
<body> 
<a href="{% url "index' %}" target=" blank"> 首页 </a> 
<hl>Hello Django</h1> 
</body> 
</html> 


上 述 代 码 是 一 个 完整 的 HTML 模板 ， 一 个 完整 的 模板 有 <head> 和 <body> 两 大 
部 分 ， 其 中 <head> 部 分 在 大 多 数 情 况 下 都 是 相同 的 ， 因 此 可 以 将 <head> 部 分 写 到 共 
用 模板 中 ， 将 共用 模板 命名 为 base.html， 代 码 如 下 : 


<!DOCTYPE html> 

<html> 

<head> 

<meta charset="UTF-8"> 
<title>{{ title }}</title> 
</head> 

<body> 

{g block body %}{% endblock %} 
</body> 

</html> 


在 base.html 的 代码 中 可 以 看 到 ，<body> 里 的 内 容 变 为 {% block body %}{% 
endblock %}，block 标签 相当 于 一 个 函数 ，body 是 对 该 函数 的 命名 ， 开 发 者 可 自行 命 
名 。 在 一 个 模板 中 可 以 添加 多 个 block 标签 ， 只 要 每 个 block 标签 的 命名 不 相同 即 可 。 
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接着 在 模板 index.html 中 调用 共用 模板 base html， 代 码 如 下 : 


{$% extends "base.html" $} 

{% block body %} 

<a href="{% url "index' $%}" target=" blank"> 首页 </a> 
<hl>Hello Django</h1> 

{$$ endblock $$} 


模板 index.html 调用 共用 模板 base.html 的 实质 是 由 模板 继承 实现 的 ， 调 用 步骤 如 
下 : 
01 在 模板 index.html 中 使 用 {% extends "base.html" %} 来 继承 模板 base.html 的 代码 。 
EI02 由 标签 {% block body %} 在 继承 模板 的 基础 上 实现 自 定义 模板 的 内 容 。 
(03 由 {% endblock %} 结束 block 标签 。 





从 index.html 看 到 ， 模 板 继承 与 Python 的 类 继承 的 原理 是 一 致 的 ， 通 过 继承 的 方 
式 使 其 具有 父 类 的 功能 和 属性 ， 然 后 以 重 写 的 方式 实现 各 种 开发 需求 。 


5.3 自 定义 过 滤器 


过 滤器 主要 是 对 变量 的 内 容 进行 处 理 ， 如 蔡 换 、 反 序 和 转 义 等 。 通 过 过 滤器 处 理 
变量 可 以 将 变量 的 数据 格式 和 内 容 转化 为 我 们 想 要 的 效果 ， 而 且 相 应 减少 视图 函数 的 
代码 量 。 过 滤器 的 使 用 方法 如 下 : 

{{ variable | filter }} 

模板 引擎 解析 带 过 滤器 的 变量 时 ， 首 先 过 滤器 filter 处理 变量 variable， 然 后 将 处 
理 后 的 变量 显示 在 网 页 上 。 其 中 ，variable 代表 模板 变量 ， 管 道 符号 “|” 代 表 变 量 使 
用 过 滤器 ，filter 代表 某 个 过 滤器 。 变 量 可 以 支持 多 个 过 滤器 同时 使 用 ， 例 如 下 : 

{{ variable | filter | lower}} 

在 使 用 的 过 程 中 ， 有 些 过 滤器 还 可 以 传 入 参数 ， 但 仅 支 持 一 个 参数 的 传 入 。 带 参 
过 滤器 的 使 用 方法 如 下 : 


{{ variable | date:"D dM Y"}} 
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Django 为 开发 者 提供 内 置 过 滤器 ， 如 表 5-3 所 示 。 
表 5-3 Django 的 内 置 过 滤器 




















内 置 过 滤器 使 用 形式 说 明 

add {{ value | add: "2"}} 将 value 的 值 增加 2 

addslashes {{ value | addslashes }} 在 value 中 的 引号 前 增加 反 斜 线 

capfirst {{ value | capfirst }} value 的 第 一 个 字符 转化 成 大 写 形式 
从 value 中 删除 所 有 arg 的 值 。 如 果 value 是 

cut {{ value | cut:arg}} "String with spaces"，arg 是 ""， 那 么 输出 
的 是 "Stringwithspaces 

date {{ value | date:"D d MY" }} 将 日 期 格式 数据 按照 给 定 的 格式 输出 


default 


{{ value | default: "nothing" 


用 


如 果 value 的 意义 是 False， 那 么 输出 值 为 
过 滤器 设 定 的 默认 值 





default_if none 


dictsort 


dictsortreversed 
divisibleby 
escape 

escapejs 


filesizeformat 


{{ value | default_if_ 
none:"nothine"}} 


{{ value | dictsort:"name"}} 


{{ value 
dictsortreversed:"name"}} 


{{ value | divisibleby:arg}} 
{{ value | escape}} 
{{ value | escapejs }} 


{{ value | filesizeformat }} 


{{ value | first }} 


如 果 value 的 意义 是 None， 那 么 输出 值 为 
过 滤器 设 定 的 默认 值 

如 果 value 的 值 是 一 个 列表 ， 里 面 的 元 素 是 
字典 ， 那 么 返回 值 按照 每 个 字典 的 关键 字 
排序 

如 果 value 的 值 是 一 个 列表 ， 里 面 的 元 素 是 
字典 ， 每 个 字典 的 关键 字 反 序 排行 

如 果 value 能 够 被 arg 整 除 ， 那 么 返回 值 将 
是 True 

控制 HTML 转 义 ， 替 换 value 中 的 某 些 
HTML 特 殊 字 符 

蔡 换 value 中 的 菜 些 字符 ， 以 适应 
JavaScript 和 JSON 格 式 

格式 化 value， 使 其 成 为 易 读 的 文件 大 小 ， 
例如 13KB、4.1MB 等 

返回 列表 中 的 第 一 个 Item， 例 如 ， 如 果 
value 是 列表 ['a','b','c']， 那 么 输出 将 
是 "a' 





floatformat 


{{ value | floatformat}} 或 
{{valuelfloatformat:arg}} 


对 数据 进行 四 合 五 入 处 理 ， 参 数 arg 是 保 
留 小 数位 ， 可 以 是 正 数 或 负数 ， 如 {{ 
valuelfloatformat:"2" }} 是 保留 两 位 小 数 。 
若 无 参 数 arg， 默 认 保留 1 位 小 数 ， 如 {{ 


valuelfloatformat}} 





get_digit 


iriencode 


{{ value | get_digit:"are"}} 


{{value | iriencode}} 


如 果 value 是 123456789，arg 是 2， 那 么 输 
出 的 是 8 
如 果 value 中 有 非 ASCII 字 符 ， 那 么 将 其 转 




















化 成 URL 中 适合 的 编码 
使 用 指定 的 字符 串 连接 一 个 list， 作 用 如 
{value [join ae 同 Python 的 strjoindlist) 
last {{ value | last }} 返回 列表 中 的 最 后 一 个 Item 
length {{ value | length }} 返回 value 的 长 度 
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说 明 





length is 


{{ value 


| length is:"arg"}} 


如 果 value 的 长 度 等 于 arg， 例 如 : value 是 
['a','b','c']，arg 是 3， 那 么 返回 True 
value 中 的 "m" 将 被 <br> 蔡 代 ， 并 且 将 整个 














linebreaks {{valuellinebreaks}} value 使 用 <p> 包 围 起 来 ， 从 而 适合 HTML 
的 格式 

linebreaksbr {{value llinebreaksbr}} value 中 的 "\n" 将 被 <br/ > 替代 

linenumbers {{value | linenumbers}} 为 显示 的 文本 添加 行 数 

ljust {{value | ljust}} 以 左 对 齐 方式 显示 value 

center {{value | center}} 以 居中 对 齐 方 式 显示 value 

Tjust {{value | rjiust}} 以 右 对 齐 方式 显示 value 


{{value 


lower}} 





make list 


pluralize 


random {{value | random}} 


removetags 


safe 


safeseq 


slugify 


{{value 


{{value 
{{value 
或 


{{value 


{{value 


make list}} 


pluralize}} 或 
| pluralize:” es” }} 





pluralize:"y,ies}} 


| removetags:"tagl 


tag2 tag3..."}} 


{{value 


{{value 


{{some | 





safe}} 


safeseq }} 


list | slice:":2"}} 


{{value | slugify}} 


将 一 个 字符 串 转 换 成 小 写 形式 

将 value 转 换 成 list。 例 如 value 是 Joel， 输 出 
fu'J',u'o',u'e',u'1']; 如 果 value 是 123， 
那么 输出 是 [1,2,3] 


将 value 返 回 英文 复数 形式 


从 给 定 的 list 中 返回 一 个 任意 的 Item 
删除 value 中 tagl,tag2… 的 标签 


关闭 HTML 转 义 ， 告 诉 Django 这 段 代码 是 
安全 的 ， 不 必 转 义 

与 上 述 safe 基 本 相同 ， 但 有 一 点 不 同 ， 
safe 针 对 字符 串 ， 而 safeseq 针 对 多 个 字符 
串 组 成 的 sequence 

与 Python 语法 中 的 slice 相 同 ，":2" 表示 截 
取 前 两 个 字符 ， 此 过 滤器 可 用 于 中 文 或 英 
区 

将 value 转 换 成 小 写 形式 ， 同 时 删除 所 有 
分 单词 字符 ， 并 将 空格 变 成 横 线 。 例 如 : 
value 是 Joel is a slug， 那 么 输出 的 将 是 joel- 


is-a-slug 

















striptags 


truncatewords 








{{value | striptags}} 
{{value |time:”H:i”}} 或 
{{value | time}} 


{{value | truncatewords:2}} 


删除 value 中 的 所 有 HTML 标 签 
格式 化 时 间 输 出 ， 如 果 time 后 面 没有 格式 
化 参数 ， 那 么 输出 按照 默认 设置 的 进行 
将 value 进 行 单词 截取 处 理 ， 参 数 2 代 表 截 
取 前 两 个 单词 ， 此 过 滤器 只 可 用 于 英文 
截取 。 如 value 是 Joel is a slug 那么 输出 将 
是 : Joelis 
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( 续 表 ) 
内 置 过 滤器 使 用 形式 说 明 
upper {{value | upper}} 转换 一 个 字符 串 为 大 写 形式 
urlencode {{value | urlencode}} 将 字符 串 进行 URLEncode 处 理 





urlize {{ value | urlize }} com， 那 么 输出 的 将 是 : Check out 《a 








将 一 个 字符 串 中 的 URL 转 化 成 可 点 击 的 形 
式 。 如 果 value 是 Check out www. baidu. 








href="http://www. baidu. com">www. 
baidu. com</a> 





wordcount {{ value | wordcount}} 返回 字符 串 中 单词 的 数目 


wordwrap {{value 





| wordwrap:5}} 按照 指定 长 度 的 分 割 字符 串 





i {{value 
timesince 





timeuntil {{value | timeuntil}} 返回 value 距 离 当 前 日 期 的 天 数 和 小 时 数 


timesince:arg}} 午夜 ， 而 value 表 示 2006-06-01 早 上 8 点 ， 





返回 参数 arg 到 value 的 天 数 和 小 时 数 。 如 
| 果 arg 是 一 个 日 期 实例 ， 表 示 2006-06-01 








那么 输出 结果 返回 “8 hours” 














在 实际 开发 中 ， 如 果 内 置 过 滤器 的 功能 不 太 适 合 实际 开发 需求 ， 我 们 可 以 通过 自 
定义 过 滤器 来 解决 问题 。 首 先 在 MyDjango 中 添加 文件 和 文件 夹 ， 如 图 5-1 所 示 。 


MyDjango ENMyDjang' 





> 


> Baindex 
> Bi MyDjango 
Y Bluser defined 
v Dtemplatetags 
材 _init_.py 
篇 myfiter.py 
也 _init_.py 
论 manage.py 
Illll External Libraries 





5-1 项 目 目录 结构 


从 图 5-1 中 看 到 ， 在 MyDjango 项 目 中 添加 了 user_defined 文件 夹 ， 在 其 文件 夹 
下 又 分 别 添加 了 templatetags 文件 夹 和 ”init _.py 文件 。templatetags 用 于 存放 自 定义 
过 滤器 的 代码 文件 ， 该 文件 夹 也 可 以 存放 在 项 目的 App 中， 但 必须 注意 的 是 ， 文 件 夹 


的 命名 必须 为 templatetags， 




















否则 Django 在 运行 的 时 候 无 法 识别 自 定义 过 滤器 。 最 后 























在 templatetags 文件 夹 下 创建 myfilter.py 文件 , 该 文件 是 编写 自 定义 过 滤器 的 实现 代码 。 


完成 过 滤器 的 目录 搭 














建 ， 接 着 是 配置 过 滤器 的 信息 ， 在 配置 文件 setingspy 的 





INSTALLED_APPS 里 面 添加 user_defined。 当 项 目 启动 时 ，Django 会 从 INSTALLED 
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APPS 的 配置 中 查找 过 滤器 ， 若 过 滤器 设置 在 index 的 目录 下 ， 则 只 需 在 
INSTALLED_APPS 中 配置 index 即 可 ， 如 图 5-2 所 示 。 








INSTALLED_APPS = [ 
“django. contrib. admain' , 
"django. contrib. auth’ , 
"django. contrib. contenttypes’ , 
"django. contrib. sessions’, 
"django. contrib. nessages’ , 
"django. contrib. staticfiles’, 
"index’, 
"user_defined’, 











图 5-2 INSTALLED_APPS 配置 信息 


完成 上 述 两 个 环境 配置 后 ， 下 一 步 是 编写 自 定义 过 滤器 的 实现 代码 ， 在 myfilterpy 
中 添加 以 下 代码 : 





from django import template 
# 声明 一 个 模板 对 象 ， 也 称 为 注册 过 滤器 
register = template.Library() 
# 声明 并 定义 过 滤器 
Q@register .filter 
def myreplace (value, agrs): 
oldValue = agrs.split(':') [0] 
newValue = agrs.split(':') [1] 
return value.replace (oldValue, newValue) 


上 述 代 码 用 于 实现 HTML 模板 的 字符 串 蔡 换 功 能 , 与 Python 的 replace 函数 相同 ， 
过 滤器 说 明 如 下 : 














ee 首先 导入 模板 功能 template， 通 过 template 声明 Library 对 象 ， 将 对 象 赋值 给 
变量 register， 这 一 过 程 称 为 注册 过 滤器 。 

e@ 过 滤器 以 函数 的 形式 实现 ， 在 函数 前 使 用 registerfilter 装饰 器 来 表示 该 函数 是 
一 个 过 滤器 ， 函 数 名 可 自行 命名 。 

@ 函数 参数 可 设置 一 个 或 两 个 ， 如 上 述 的 参数 分 别 是 value 和 agrs， 参 数 value 
是 HTML 模板 的 变量 ， 参 数 agrs 是 过 滤器 函数 定义 的 函数 参数 。 

日 ”过 滤器 函数 最 后 必须 将 处 理 结果 返回 ， 否 则 在 使 用 过 程 中 会 出 现 异 常 信息 。 

















最 后 在 HIML 模板 中 使 用 我 们 自 定 义 的 过 滤器 ， 以 index.html 模板 的 title 为 例 ， 
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代码 如 下 : 


{$$ load myfilter $%} 
<!DOCTYPE html> 
<html> 

<head> 


<title>{{ titlelmyreplace:' 首页 : 我 的 首页 ' }}</title> 
<meta charset="utf-8"> 

{g% load staticfiles $%} 

<link rel="stylesheet" type="text/css" href="{% static "css/hw_ index. 


Caa™ SY > 
<link rel="icon" href="{% static "img/hw.ico" %}"> 
<script src="{% static "js/hw index.js" %}"></script> 
</head> 


在 HTML 模板 中 使 用 自 定义 的 过 滤器 可 以 分 为 两 大 步骤 ， 说 明 如 下 : 


{% load myfilter %} 用 于 导入 templatetags 文件 夹 的 myfilterpy 文件 中 所 定义 
的 功能 ， 用 来 告诉 Django 在 哪个 地 方 可 以 找到 自 定义 过 滤器 。 

{{ titlelmyreplace:' 首页 :我 的 首页 ' }} 把 变量 title 含 有 “首页 ”的 内 容 替 换 成 “我 
的 首页 ”。 其 中 ，myreplace 是 过 滤器 的 函数 名 ，“ 首 页 : 我 的 首页 ”是 函数 参 
数 agrs 的 值 ， 函 数 参 数 value 的 值 为 模板 变量 title 的 值 。 运行 结果 如 图 5-3 所 示 。 


C [O12700.1:8000 





华为 官网 。 华为 荣 座 


VMALL én 


图 5-3 运行 结果 








5.4 本 章 小 结 





Django 作为 Web 框架 ， 需 要 一 种 很 便利 的 方法 去 动态 地 生成 HTML 网 页 ， 因 此 

















有 了 模板 这 个 概念 。 模 板 包 含 所 需 HTML 的 部 分 代码 以 及 一 些 特殊 的 语法 ， 特 殊 的 











语法 用 于 





描述 如 何 将 数据 动态 插入 HTML 网 页 中 。 
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模板 语言 主要 在 HTML 文件 中 编写 ， 大 概 分 为 三 类 : 变量 、 标 签 和 过 滤器 。 三 
者 说 明 如 下 : 
e ”变量 是 将 视图 函数 传递 的 数据 作用 在 模板 文件 上 ， 通 过 模板 引擎 将 数据 转换 
并 生成 HIML 网 页 。 
@。 标签 可 以 理解 为 代码 编程 里 面 的 函数 功能 ， 常 用 的 标签 有 控制 循环 、 条 件 判 
断 和 模板 继承 等 。 
。 过 滤器 主要 是 对 变量 的 数据 进行 处 理 ， 如 替换 、 反 序 和 转 义 等 。 


模板 继承 与 Python 的 类 继承 的 原理 是 一 致 的 ， 通 过 继承 的 方式 使 其 具有 父 类 的 
功能 和 属性 ， 然 后 以 重 写 的 方式 实现 各 种 开发 需求 。 模 板 继承 的 实现 步骤 如 下 
人 I01 在 模板 index.html 中 使 用 {% extends "base.html" %} 来 继承 模板 base.html 的 代码 。 
02 由 标签 {% block body %} 在 继承 模板 的 基础 上 实现 自 定义 模板 的 内 容 。 
人 3 由 {% endblock %} 结束 block 标签 。 

过 滤器 主要 是 对 变量 的 内 容 进 行 处 理 ， 如 蔡 换 、 反 序 和 转 义 等 。 通 过 过 滤器 处 理 


变量 可 以 将 变量 的 数据 格式 和 内 容 转 化 为 我 们 想 要 的 效果 ， 而 且 相 应 减少 视图 函数 的 
代码 量 。 过 滤器 的 使 用 方法 如 下 : 


{{ variable | filter }} 


模板 引擎 解析 带 过 滤器 的 变量 时 ， 首 先 过 滤器 filter 处 理 变量 variable， 然 后 将 处 
理 后 的 变量 显示 在 网 页 上 。 其 中 ，variable 代表 模板 变量 ， 管 道 符号 “|” 代 表 变 量 使 
用 过 滤器 ，filter 代表 某 个 过 滤器 。 变 量 可 以 支持 多 个 过 滤器 同时 使 用 ， 例 如 : 


{{ variable | filter | lower}} 


在 使 用 的 过 程 中 ， 有 些 过 滤器 还 可 以 传 入 参数 ， 但 仅 支 持 一 个 参数 的 传 入 。 带 参 
过 滤器 的 使 用 方法 如 下 : 


{{ variable | date:"DdMY"}} 
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Django 对 各 种 数据 库 提 供 了 很 好 的 支持 ， 包 括 : PostgreSQL、MySQL、SQLite 
和 Oracle， 而 且 为 这 些 数 据 库 提供 了 统一 的 调用 API， 这 些 API 统称 为 ORM 框架 。 
通过 使 用 Django 内 置 的 ORM 框架 可 以 实现 数据 库 连 接 和 读 写 操作 。 


6.1 构建 模型 


ORM 框架 是 一 种 程序 技术 ， 用 于 实现 面向 对 象 编程 语言 中 不 同类 型 系统 的 数据 
之 间 的 转换 。 从 效果 上 说 ， 其 实 是 创建 了 一 个 可 在 编程 语言 中 使 用 的 “虚拟 对 象 数据 
库 ”， 通 过 对 虚拟 对 象 数据 库 操作 从 而 实现 对 目标 数据 库 的 操作 ， 虚 拟 对 象 数据 库 与 
目标 数据 库 是 相互 对 应 的 。 在 Django 中 ， 虚 拟 对 象 数据 库 也 称 为 模型 。 通 过 模型 实 
现 对 目标 数据 库 的 读 写 操作 ， 实 现 方法 如 下 : 








第 6 章 模型 与 数据 库 





(1) 配置 目标 数据 库 信息 ， 主 要 在 settings.py 中 设置 数据 库 信息 ， 具 体 配置 步 
又 可 查看 2.4 节 。 


(2) 构建 虚拟 对 象 数 据 库 ， 在 App 的 models.py 文件 中 以 类 的 形式 定义 模型 。 
(3) 通过 模型 在 目标 数据 库 中 创建 相应 的 数据 表 。 
(4) 在 视图 函数 中 通过 对 模型 操作 实现 目标 数据 库 的 读 写 操作 。 


本 节 主 要 讲述 如 何 构建 模型 并 通过 模型 在 目标 数据 库 中 生成 相应 的 数据 表 。 在 
此 之 前 ， 读 者 可 回 到 2.4 节 查 看 如 何 配置 目标 数据 库 信 息 。 以 MyDjango 项 目 为 例 ， 
其 配置 信息 如 下 : 





# MyDjango 项 目的 settings .py 文件 的 DATABASES 配置 信息 
DATABASES = { 
'default': { 
'ENGINE': 'django.db.backends.mysql', 
'NAME': 'mydjango', 
'USER': '‘'root', 
'PASSWORD': '1234', 
HOST “127:0.0:1"s 
'PORT': '3306', 
Pe 
} 


我 们 使 用 Navicat Premium 数据 库 管理 工具 (Navicat Premium 是 一 个 可 视 化 数据 
库 管 理工 具 ， 读 者 可 自行 在 网 上 搜索 该 工具 并 安装 使 用 ) 查看 当前 mydjango 数据 库 
的 信息 ， 如 图 6-1 所 示 。 








Y 号 mydjango 
国 表 

>》 oo 视图 
》. 妨 函数 
> 权 事件 
> 本 查询 
》 国 报表 
> 四 备份 


图 6-1 数据 库 信息 




















从 图 6-1 中 可 以 看 到 ，mydjango 数据 库 当 前 没有 数据 表 ， 而 数据 表 只 能 通过 模 
型 创建 ， 因 为 Django 对 模型 和 目标 数据 库 之 间 有 自身 的 映射 规则 ， 如 果 自 己 在 数据 
库 中 创建 数据 表 ， 可 能 不 一 定 符合 Django 的 建 表 规则 ， 从 而 导致 模型 和 目标 数据 库 
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无 法 建立 通信 联系 。 大 概 了 解 项 目的 环境 后 ， 在 项 目 index 的 modelspy 文件 中 定义 
模型 ， 代 码 如 下 : 


from django.db import models 

# Create your models here. 

# 创建 产品 分 类 表 

class Type (models.Model): 
id = models.AutoField (primary key=True) 
type name = models.CharField (max length=20) 

# 创建 产品 信息 表 

class Product (models.Model): 
id = models.AutoField (primary key=True) 
name = models.CharField (max length=50) 
weight = models.CharField (max length=20) 
size = models.CharField (max length=20) 
type = models.ForeignKey (Type, on delete=models.CASCADE) 


上 述 代码 分 别 定 义 了 模型 Type 和 Product， 定 义 说 明 如 下 : 


。 ”模型 以 类 的 形式 进行 定义 ， 并 且 继 承 Django 的 models.Model 类 。 一 个 类 代表 
目标 数据 库 的 一 张 数据 表 ， 类 的 命名 一 般 以 首 字母 大 写 开头 。 

e ”模型 的 字段 以 类 属性 进行 定义 ， 如 id = models.IntegerField(primary key=True) 
代表 在 数据 表 Type 中 命名 一 个 名 为 id 的 字段 ， 该 字段 的 数据 类 型 为 整 型 并 设 
置 为 主键 。 


完成 模型 的 定义 后 ， 接 着 在 目标 数据 库 中 创建 相应 的 数据 表 ， 在 目标 数据 库 中 创 
建 表 是 通过 Django 的 管理 工具 manage.py 完成 的 ， 创 建 表 的 指令 如 下 : 


# 根据 models .py 内 容 生成 相关 的 py 文件 ， 该 文件 用 于 创建 数据 表 
E:\MyDjango>python manage.py makemigrations 
Migrations for '‘'index': 
index\migrations\000]1 initial.py 

- Create model Product 

- Create model Type 

- Add field type to product 
# 创建 数据 表 


E:\MyDjango>python manage.py migrate 


在 目标 数据 库 中 创建 数据 表 需 要 执行 两 次 指令 ,分 别 是 makemigrations 和 migrate 
指令 。 创 建 过 程 说 明 如 下 : 


makemigrations 指令 用 于 将 index 所 定义 的 模型 生成 0001_initialpy 文件 ， 该 文件 存 
放 在 index 的 migrations 文件 夹 , 打开 查看 0001_initial.py 文件 , 其 文件 内 容 如 图 6-2 所 示 。 


2 
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om ajango.db import migrations, model3 
limport django.db.models.deletion 





migrar 







models.CharField (max_length=50)), 
', models.IntegerField()), 
dels.CharField (nax_length=20)), 


) 
migrations.CreateModel( 


models.CharField (max_length=20)), 


)， 

migrations.AddField( 

model_name="product, 
name=Try 


)， 
] 





', models. IntegerField(primary key=True, serialize=False)), 


', models, IntegerField(primary_key=True, serialize=False)), 


field=model3. Foreignkey (on_delete=django.db.models. deletion.CASCADE, to="index,Type'), 

















图 6-2 0001_initial.py 文件 内 容 





0001_initial.py 文件 将 models.py 的 内 容 生 成 数据 表 的 脚本 代码 。 而 migrate 指令 
根据 脚本 代码 在 目标 数据 库 中 生成 相对 应 的 数据 表 。 指 令 运行 完成 后 ， 可 在 数据 库 看 


到 已 创建 的 数据 表 ， 如 图 6-3 所 示 。 







上 auth_group 

Eauth_ group_permissions 
auth_permission 
auth_user 
auth_user_groups 
auth_user_user_permissions 
django admin log 
django content type 
django _ migrations 
django_session 
index_product 

国 index type 








图 6-3 已 创建 的 数据 表 
从 图 6-3 中 看 到 ， 数 据 表 index_product 和 index_type 是 








1 index 的 模型 所 创建 的 ， 

















分 别 对 应 模型 Product 和 Type。 其 他 数据 表 是 Django 内 置 功能 所 使 用 的 数据 表 ， 分 

















别 是 会 话 session、 用 户 认 证 管理 和 Admin 日 志 记 录 等 。 











在 上 述 例 子 中 ， 我 们 创建 了 数据 表 index_product 和 index_ type， 而 表 字 段 是 在 模 
型 中 定义 的 ， 在 模型 Type 和 Product 中 定义 的 字段 类 型 有 整 型 和 字符 串 类 型 ， 但 在 实 





际 开 发 中 ， 我 们 需要 定义 不 同 的 数据 类 型 来 满足 各 种 需求 ， 
不 同 的 数据 类 型 ， 如 表 6-1 所 示 。 

















此 Django 划分 了 多 种 





73 


玩 转 Django 2.0 


表 6-1 表 字 段 数 据 类 型 及 说 明 














表 字 段 说 明 
models.AutoField 默认 会 生成 一 个 名 为 id 的 字段 并 为 int 类 型 
models.CharField 字符 串 类 型 
models.BooleanField 布尔 类 型 

ee 
models.DateField 日 期 (date) 类 型 


models.DateTimeField 日 期 (datetime ) 类 型 

Imodels.Decimal 十 进 制 小 数 类 型 

models.EmailField 字符 串 类 型 (正则 表达 式 邮 箱 》 

models.FloatField 浮 点 类 型 
a 

models.BigIntegerField 长 整数 类 型 

models.IPAddressField 字符 串 类 型 (IPv4 正 则 表达 式 ) 
models.GenericIPAddressField ee 和 a A otocol 可 以 是 ，both、IPv4 和 


包 入 字母 数字 、 下 画 线 和 连 字符 的 字符 串 ， 常 用 于 


小 整数 类 型 ， 取 值 范围 (-32,768~+32,767) 
长 文本 类 型 
时 间 类 型 ， 显 示 时 分 秒 HHMM[:ssLuuuuuu]] 
字符 串 ， 地 址 为 正则 表达 式 
二 进 制 数据 类 型 
从 表 6-1 中 可 以 看 到 ，Django 提供 的 字段 类 型 还 会 对 数据 进行 正则 处 理 和 验证 功 
能 等 ， 进 一 步 完 善 了 数据 的 严谨 性 。 除 了 表 字 段 类 型 之 外 ， 每 个 表 字 段 还 可 以 设置 相 
应 的 参数 ， 使 得 表 字 段 更 加 完善 。 字 段 参 数 说 明 如 表 6-2 所 示 。 


表 6-2 表 字 段 参数 及 说 明 






























说 明 
| 如 为 True， 字 段 是 否 可 以 为 空 

如 为 Tmue， 设 置 在 Admin 站 点 管理 中 添加 数据 时 可 允许 空 值 
设置 默认 值 

如 为 Te， 将 字段 设置 成 主键 
设置 数据 库 中 的 字段 名 称 

| 如 为 Tme， 将 字段 设置 成 唯一 属性 ， 默 认为 False 
如 为 True， 为 字段 添加 数据 库 索引 

















Default 
primary_ key 
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参数 | 说 明 





Verbose name | 在 Admin 站 点 管理 设置 字段 的 显示 名 称 


关联 对 象 反 向 引用 描述 符 ， 用 于 多 表 查 询 ， 可 解决 一 个 数据 表 有 两 个 外 
键 同时 指向 另 一 个 数据 表 而 出 现 重 名 的 问题 





Telated_name 








6.2 数据 表 的 关系 


一 个 模型 对 应 目标 数据 库 的 一 个 数据 表 ， 但 我 们 知道 ， 每 个 数据 表 之 间 是 可 以 存 
在 关联 的 ， 表 与 表 之 间 有 三 种 关系 : 一 对 一 、 一 对 多 和 多 对 多 。 
一 对 一 存在 于 在 两 个 数据 表 中 ， 第 一 个 表 的 某 一 行 数据 只 与 第 二 个 表 的 某 一 行 数 
据 相 关 ， 同 时 第 二 个 表 的 某 一 行 数据 也 只 与 第 一 个 表 的 某 一 行 数据 相关 ， 这 种 表 关 系 
被 称 为 一 对 一 关系 ， 以 表 6-3 和 表 6-4 为 例 进行 说 明 。 
表 6-3 一 对 一 关系 的 第 一 个 表 


ID HH | 加 籍 [és 加 节目 | 
ol JEXAk 钵 | 国 | 万 万 汉 想到 | 


表 6-4 一 对 一 关系 的 第 二 个 表 
ID | 出生 日 其 

















在 上 述 两 个 表 中 ， 表 6-3 和 表 6-4 的 字段 用 分别 是 一 一 对 应 的 ， 并 且 不 会 在 同 
一 表 中 有 重复 ID， 使 用 这 种 关系 通常 是 一 个 数据 表 有 太 多 字段 ， 将 常用 的 字段 抽取 
出 来 并 组 成 一 个 新 的 数据 表 。 在 模型 中 可 以 通过 OneToOneField 来 构建 数据 表 的 一 对 
# 一 对 一 关系 
class Performer (models.Model): 
id = models.IntegerField(primary key=True) 


name = models.CharField (max length=20) 
nationality = models.CharField (max length=20) 


Fd 
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masterpiece = models.CharField (max length=50) 


class Performer info(models.Model): 
id = models.IntegerField(primary key=True) 
performer = models.OneToOneField (Performer, on delete=models.CASCADE) 
birth = models.CharField (max length=20) 
elapse = models.CharField (max length=20) 





使 用 Django 的 管理 工具 manage.py 创建 数据 表 Performer 和 Performer info， 创 
建 数 据 表 前 最 好 先 删 除 0001_initial py 文件 并 清空 数据 库 里 的 数据 表 。 数 据 表 的 表 关 
系 如 图 6-4 所 示 。 


国 index_performer @mydjango (MyDB) - =- 口 
X+ 声 和 故事 QD 才 动 
入 

间 name 。 nationalby macierpiece 


ww»,*«"o 
币 1TEER 孙 





有 | Bsr 区 sd 





+ es mw19qao 回忆 
第 1TEEBB 


图 6-4 一 对 一 关系 
一 对 多 存在 于 两 个 或 两 个 以 上 的 数据 表 中 ， 第 一 个 表 的 数据 可 以 与 第 二 个 表 的 
一 到 多 行 数 据 进行 关联 ， 但 是 第 二 个 表 的 每 一 行 数据 只 能 与 第 一 个 表 的 某 一 行进 行 关 
联 ， 以 表 6-5 和 表 6-6 为 例 进 行 说 明 。 


表 6-5 一 对 一 多 关系 的 第 一 个 表 


























003 刀锋 女王 本 
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在 上 面 的 表 6-6 中 ， 字 段 ID 的 数据 可 以 重复 并 且 在 表 6-5 中 找到 对 应 的 数 
据 ， 而 表 1 的 字段 卫 是 唯一 的 ， 这 是 一 种 最 为 常见 的 表 关 系 。 在 模型 中 可 以 通过 
ForeignKey 来 构建 数据 表 的 一 对 多 关系 ， 代 码 如 下 : 











# 一 对 多 关系 

Class Performer (models.Model): 
id = models.IntegerField(primary key=True) 
name = models.CharField (max length=20) 
nationality = models.CharField (max length=20) 


class Program(models.Model): 
id = models.IntegerField (primary key=True) 


performer = models.ForeignKey (Performer, on_ delete=models.CASCADE) 
name = models.CharField (max length=20) 





使 用 Django 的 管理 工具 manage.py 创建 数据 表 Performer 和 Program， 创 建 数 据 
表 前 最 好 先 删 除 0001_initial.py 文件 并 清空 数据 库 里 的 数据 表 。 数 据 表 的 表 关 系 如 
6-5 所 示 。 


图 index_performer @mydjango [MyD8) -去 - 5 配 杞 
Zr 四 @D 3 

i 本 相 四 且 轩 于 4 

Waname ationaiy 





| 
si 


6-5 一 对 多 关系 


多 对 多 存在 于 在 两 个 或 两 个 以 上 的 数据 表 中 ， 第 一 个 表 的 某 一 行 数据 可 以 与 第 


二 个 表 的 一 到 多 行 数据 进行 关联 ， 同 时 在 第 二 个 表 中 的 某 一 行 数据 也 可 以 与 第 一 个 表 
的 一 到 多 行 数据 进行 关联 ， 以 表 6-7 和 表 6-9 为 例 进行 说 明 。 




















表 6-7 多 对 多 关系 的 第 一 个 表 
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表 6-8 多 对 多 关系 的 第 二 个 表 























从 上 面 的 三 个 数据 表 中 可 以 发 现 ， 一 个 演员 可 以 参加 多 个 节目 ， 而 一 个 节目 也 可 
以 由 多 个 演员 来 共同 演出 。 每 个 表 的 字段 ID 都 是 唯一 的 ， 在 表 6-9 中 可 以 发 现 ， 节 
目 ID 和 演员 ID 出 现 了 重复 的 数据 ， 分 别 对 应 表 6-8 和 表 6-7 的 字段 ID， 多 对 多 关系 
需要 使 用 新 的 数据 表 来 管理 两 个 表 的 数据 关系 。 在 模型 中 可 以 通过 ManyToManyField 
来 构建 数据 表 多 的 对 多 关系 ， 代 码 如 下 : 




















# 多 对 多 

class Performer (models.Model): 
id = models.IntegerField(primary key=True) 
name = models.CharField (max length=20) 
nationality = models.CharField (max_ length=20) 


图 index_performer @mydjango (MyDB) -去 - 5 本 
六 多 生理 碍 定 D 有 
忆 es 二。 国名 "本 GE 且 F 区 SA 了 SJ 


class Program(models.Model): 
id = models . 








IntegerField (primary key=True) dname natonaliy 
name = models. ER 
_ i + ee wm1+r# 国 昌 
CharField (max_ length=20) 百 pr 二 本 
performer = models. we 二 ”证 D 帮助 
ManyToManyField (Performer) Pe 备 主 - 可 5 下 丘 # 臣 SA 配 y 
由 am 


Django 创建 多 对 多 关系 的 时 候 只 
需 定义 两 个 数据 库 对 象 ， 在 创建 目标 百 
数据 表 的 时 候 会 自动 生成 三 个 数据 表 5 天 Bs- 
来 建立 多 对 多 关系 ， 如 图 6.6 所 示 。 ， 


二 es w*1* 小 o 国 旦 
答 1 页 天 iD 录 


6-6 多 对 多 关系 





me1e9agl 回 四 
gram_periormer @mydjango (MyDB) - 去。 - 口 大 也 
Ba 
JENFF 区 SA 了 苇 S4 














网 
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6.3 数据 表 的 读 写 

前 两 节 主 要 通过 对 模型 的 定义 来 构建 目标 数据 库 的 数据 表 ， 而 本 节 主 要 通过 模 
型 的 操作 来 实现 目标 数据 库 的 读 写 操作 。 数 据 库 的 读 写 操作 主要 对 数据 进行 增 、 删 、 
改 、 查 。 以 6.1 节 的 数据 表 index_type 和 index_product 为 例 ， 分 别 在 两 个 数据 表 中 添 
加 如 图 6-7 和 图 6-8 所 示 的 数据 。 








文人 第 入 查看 宣 口 。 帮助 
好 和 Hi 事务 国 备 证" 本 BE 且 失 序 区 SA 了 苇 SL 


v 
w+*1+ 必 国电 
第 1 条 记录 共 4 全 于 第 1 页 


6-7 表 index_type 中 的 数据 信息 








size ypejd 
157,00"74.98*6.97mm 
156.9"75.17.5mm 
248"173"7.8mm 

229.8"159.8"7.95 mm 


5 PORSCHE DESIGN 45"483"12.6 
6 华为 运动 手 环 44"197"103mm 


7 苇 到 和 克 动 电源 10000m, 210g 13973.7"155mm 
8 半 送 休 加 任 1850g 。 300"300"237mm 


v x ee@ me1e#q 必 | 国 四 
得 1 冬 i3 有 共 11 名 ) 于 和 1 页 


图 6-8 表 index_product 中 的 数据 信息 





为 了 更 好 地 演示 数据 库 的 读 写 操作 ， 在 MyDjango 项 目 中 使 用 shell 模式 ( 启 
动 命令 行 和 执行 脚本 ) 进行 讲述 ， 该 模式 主要 为 方便 开发 人 员 开 发 和 调试 程序 。 在 
PyCharm 的 Terminal 下 开启 shell 模式 ， 输 入 python manage.py shell 指令 即 可 开启 ， 
如 图 6-9 所 示 。 
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Terminal 
Er 








(InteractiveConsole) 





也 4Run 内 5Debug 宝 5TODO 哆 Python Console Bo 


图 6-9 启动 shell 模式 





在 shell 模式 下 ， 若 想 对 数据 表 index_product 插入 数据 ， 则 可 输入 以 下 代码 实现 ; 


>>> from index.models import * 
>>> p = Product () 


>>> p.name = ' 荣耀 V9， 
>>> p.weight = '111g' 

>>> p.size = '120*75*7mm' 
>>> p.type _ id= 1 

>>> p.save() 


通过 对 模型 Product 进 行 操作 实现 数据 表 index_product 的 数据 插入 , 插入 方式 如 下 : 





人 ED 从 models.py 中 导入 模型 Product。 
人 2 对 模型 Product 声明 并 实例 化 ， 生 成 对 象 p。 


03 对 对 象 p 的 属性 进行 逐一 赋值 ,对象 p 的 属性 来 自 于 模型 Product 所 定义 的 字段 。 
完成 赋值 后 需要 对 p 进行 保存 才能 作用 在 目标 数据 库 。 























需要 注意 的 是 ， 模 型 Product 的 外 键 命名 为 type， 但 在 目标 数据 库 中 变 为 type_ 
id， 因 此 对 对 象 p 进行 赋值 的 时 候 ， 外 键 的 赋值 应 以 目标 数据 库 的 字段 名 为 准 。 
上 述 代码 运行 结束 后 ， 可 以 在 数据 库 中 查看 数据 的 插入 情况 ， 如 图 6-10 所 示 。 

















查看。 定 口 。 和 帮助 

图 各 注 " 本 直上 #g 共 SA 加 SL 
size bype jd 
157.00"74.98"6.97mm 
156975475mm 
248"1737.8mm 
229.8*159.8*7.95 mm 


45"48.3"12.6 
44"197"103mm 
139737"155mm 
300"300"23.7mm 














图 6-10 数据 入 库 
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除了 上 述 方法 外 ， 数 据 的 插入 还 有 以 下 两 种 方式 ， 代 码 如 下 : 


# 方 法 一 

# 通过 Django 的 oRM 框架 提供 的 API 实现 ， 使 用 create 方法 实现 数据 插入 

>>> Product .objects.create (name=' 荣 炮 V9',weight='111g',size='120*75*7mm', 
type id=1) 

# 方法 二 

# 在 实例 化 时 直接 设置 属性 值 

>>> p = Product (name=' 荣耀 V9',weight='111g',size='120*75*7mm',type_ id=1) 

>>> p.save() 


如 果 想 对 现 有 的 数据 进行 更 新 ， 实 现 步骤 与 数据 插入 的 方法 大 致 相同 ， 唯 一 的 区 
别 是 在 模型 实例 化 之 后 ， 要 更 新 数据 ， 需 要 先进 行 一 次 数据 查询 ， 将 查询 结果 以 对 象 
的 形式 赋 给 p， 最 后 对 p 的 属性 重新 赋值 就 能 实现 数据 的 更 新 ， 代 码 如 下 

















>>> p = Product.objects.get (id=9) 
>>> p.name = ' 华为 荣 炮 V9' 


>>> p.save() 


上 述 代码 运行 结束 后 ， 可 以 在 数据 库 中 查看 数据 更 新 的 情况 ， 如 图 6-11 所 示 。 


文件 六 名 查看 宣 口 帮助 
各 主 - 下 先生 上 并 四 SA 四 5 出 
id name i size 
1 美丽 V10 157.00"74.98"6.97mm 
2 HUAWEI nova 25 156.9"75.1"7.5mm 
248"1737.8mm 
2298"159.8"7.95 mm 
5 PORSCHE DESIGN 45°48.3"12.6 
6 华为 运动 手 环 44"19.7°"10.3mm 
7 荣 表 移动 电源 10000m/210g 139737"155mm 
8 荣 浴 体 朋 笠 1850g 300*300"23.7mm 


v 
mw19q 回 蝇 
第 9 条 记录 ( 共 11 条 ) 于 第 1 页 


图 6-11 数据 更 新 








除 此 之 外 ， 还 可 以 使 用 update 方法 实现 单条 或 多 条 数据 的 更 新 ， 使 用 方法 如 下 : 





# 通过 Django 的 ORM 框架 提供 的 API 实现 

# 更 新 单条 数据 ， 查 询 条 件 get 适用 于 查询 单条 数据 

Product .objects .get (id=9) .update (name=" 华为 荣耀 V97) 

# 更 新 多 条 数据 ， 查 询 条 件 flter 以 列表 格式 返回 ， 查 询 结果 可 能 是 一 条 或 多 条 数据 
Product .objects .filter (name=' 荣耀 V9') .update (name=' 华为 荣 炮 V9' ) 

# 全 表 数 据 更 新 ， 不 使 用 查询 条 件 ， 默 认 对 全 表 的 数据 进行 更 新 

Product .objects .update (name=' 华为 荣 炮 V9' ) 














81 


玩 转 Django 2.0 


如 果 要 对 数据 进行 删除 处 理 ， 有 三 种 方式 : 删除 表 中 全 部 数据 、 删 除 一 条 数据 和 


删除 多 条 数据 。 实 现 三 种 删除 方式 的 代码 如 下 : 


# 删除 表 中 全 部 数据 

Product .objects.all() .delete() 

# 删除 一 条 ia 为 1 的 数据 

Product .objects .get (id=1) .delete () 

# 删除 多 条 数据 

Product .objects .filter (name=' 华为 荣耀 V9') .delete() 


数据 删除 由 ORM 框架 的 delete 方法 实现 。 从 数据 的 删除 和 更 新 可 以 看 到 这 两 种 


数据 操作 都 使 用 查询 条 件 get 和 filter， 查 询 条 件 get 和 filter 的 区 别 如 下 。 


。 ”查询 条 件 get: 查询 字段 必须 是 主键 或 者 唯一 约束 的 字段 ， 并 且 查 询 的 数据 必 
须 存 在 ， 如 果 查 询 的 字段 有 重复 值 或 者 查询 的 数据 不 存在 ， 程 序 都 会 抛 出 异 
常 信息 。 

e ”查询 条 件 filter: 查询 字段 没有 限制 ， 只 要 该 字段 是 数据 表 的 某 一 字段 即 可 。 
查询 结果 以 列表 的 形式 返回 ， 如 果 查 询 结果 为 空 (查询 的 数据 在 数据 库 中 找 
不 到 ) ， 就 返回 空 列表 。 


数据 查询 是 数据 库 操作 中 最 为 复杂 并 且 内 容 最 多 的 部 分 ， 我 们 以 代码 的 形式 来 讲 


述 如 何 通过 ORM 框架 提供 的 API 实现 数据 查询 ， 代 码 如 下 : 
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>>> from index.models import * 

# 全 表 查 询 ， 等 同 于 SQL 语句 Select * from index_product， 数据 以 列表 形式 返回 
>>> p = Product.objects.all () 

>>> p[1] .name 

'HUAWEI nova 2s' 


# 查询 前 5 条 数据 ， 等 同 于 SQL 语句 Select * from index product LIMIT 5 
# SQL 语句 里 面 的 LIMIT 方法 ， 在 Django 中 使 用 Python 的 列表 截取 分 解 即 可 实现 
>>> p = Product.objects.all()[:5] 


# 查询 某 个 字段 ， 等 同 于 SQL 语句 Select name from index product 
# values 方法 ， 以 列表 形式 返回 数据 ， 列 表 元 素 以 字典 格式 表示 

>>> p = Product.objects.values('name') 

>>> p[l]['name'] 

'HUAWET nova 2s' 


# values_1ist 方法 ， 以 列表 表示 返回 数据 ， 列 表 元 素 以 元 组 格式 表示 
>>> p = Product.objects.values list('name')[:3] 
Sy PB 
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<QuerySet [(' 荣耀 V10',)，('HUAWEI nova 2s')，(' 荣耀 Waterplay'y)]> 


# 使 用 get 方法 查询 数据 ， 等 于 同 SQL 语句 Select*from index product where id=2 
>>> p = Product.objects.get (id = 2) 

>>> p.name 

'HUAWEI nova 2s' 


# 使 用 filter 方法 查询 数据 ， 注 意 区 分 get 和 filter 的 差异 
>>> p = Product.objects.filter (id = 2) 

>>> p[0] .name 

'HUAWEI nova 2s' 


# SQL 的 and 查询 主要 在 flter 里 面 添加 多 个 查询 条 件 

>>> p = Product .objects .filter (name=' 华为 荣耀 V9'!， id=9) 
>>> P 

<QuerySet [<Product: Product object (9)>]> 


# SQL 的 or 查询 ， 需 要 引入 8， 编 写 格 式 : Q (field=value) |Q (field=value) 

# 等 同 于 SQL 语句 Select * from index product where name=' 华为 荣耀 V9' or id=9 
>>> from django.db.models import Q 

>>> p = Product.objects .filter (Q (name=' 华为 荣耀 V9') 1Q(id=9)) 

>>> p 

<QuerySet [<Product: Product object (9)>, <Product: Product object (10)>]> 


# 使 用 count 方法 统计 查询 数据 的 数据 量 
>>> p = Product .objects .filter (name=' 华为 荣耀 V9') .count () 
>>> P 


2 


# 去 重 查询 ，di stinct 方法 无 须 设置 参数 ， 去 重 方式 根据 values 设置 的 字段 执行 

# 等 同 SQL 语句 Select DISTINCT name from index product where name = "' 华为 荣 
>>> p = Product.objects.values ('name') .filter (name=' 华为 荣耀 V9') .distinct () 
>>> P 

<QuerySet [{'name'!: ' 华为 荣耀 V9'}]> 


# 根据 字段 id 降序 排列 ， 降 序 只 要 在 order_by 里 面 的 字段 前 面 加 "-" 即 可 

# order_by 可 设置 多 字段 排列 ， 如 Product .objects-order_ by('-id'，'name') 
>>> P = Product.objects.order by('-id') 

>>>p 


# 聚合 查询 ， 实 现 对 数据 值 求 和 、 求 平均 值 等 。Django 提供 annotate 和 aggregate 方法 实现 
# annotate 类 似 于 SQL 里 面 的 GROUP BY 方法 ， 如 果 不 设置 values， 就 会 默认 对 主键 进行 


GROUP BY 分 组 


# 等 同 于 SQL 语句 Select name,SUM(id) AS "id sum' from index product GROUP 


BY name ORDER BY NULL 


>>> from django.db.models import Sum, Count 
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>>> p = Product.objects.values('name') .annotate (sum('id')) 
>>> print (p.query) 


# aggregate 是 将 某 个 字段 的 值 进 行 计算 并 只 返回 计算 结果 

# 等 同 于 SQL 语句 Select COUNT (id) RS 'id count' from index product 

>>> from django.db.models import Count 

>>> p = Product.objects -aggregate (id_count=Count ('"id') ) 

a zj 

上 述 代码 讲述 了 日 常 开发 中 常用 的 数据 查询 方法 ， 但 有 时 候 需要 设置 不 同 的 查询 
条 件 来 满足 多 方面 的 查询 要 求 。 上 述 例子 中 ， 查 询 条 件 flter 和 get 使 用 等 值 的 方法 来 
匹配 结果 。 若 想 使 用 大 于 、 不 等 于 和 模糊 查询 的 匹配 方法 ， 则 可 以 使 用 表 6-10 所 示 
的 匹配 符 实现 。 


表 6-10 匹配 符 的 使 用 及 说 明 


匹配 符 使 用 说 明 
__ exact filter(name _ exact=' 荣光 ') 精确 等 于 ， 如 SQL 的 like' 荣 兆 ' 
_iexact filter(name _iexact=' 荣 炮 ') 精确 等 于 并 忽略 大 小 写 


__contains filter(name _contains=' 荣光 ') 模糊 匹配 ， 如 SQL 的 like “% 荣 泡 %' 
_ icontains filter(name _icontains=' 荣光 ') 模糊 匹配 ， 忽 略 大 小 写 


大 于 
大 于 等 于 
小 于 
_ lte filter(id _ lte=5) 小 于 等 于 


判断 是 否 在 列表 内 

以 开关 
_ istartswith ”| filter(name_istartswith=' 荣 泡 ') | 以 ... 开 头 并 忽略 大 小 写 
_ endswith filter(name endswith=' 荣 兆 ') 以 .结尾 
_ iendswith filtername_iendswith= "荣耀 ) | 以 ... 结 尾 并 忽略 大 小 写 




















_ range filter(name range=' 荣 泡 ') 在 ... 范 围 内 
日 期 字段 的 年 从 
日 期 字段 的 月 份 
__day filter(date _ day=30) 日 期 字段 的 天 数 
__isnull filter(name isnull=True/False) 判断 是 否 为 空 





从 表 6-3 中 可 以 看 到 ， 只 要 在 查询 的 字段 后 添加 相应 的 匹配 符 ， 就 能 实现 多 种 不 
同 的 数据 查询 ， 如 filter(id gt=9) 用 于 获取 字段 id 大 于 9 的 数据 。 在 shell 模式 下 使 
用 该 匹配 符 进行 数据 查询 ， 代 码 如 下 : 














>>> from index.models import * 
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>>> p = Product.objects .filter (id gt=9) 

>>> p 

<QuerySet [<Product: Product object (10)>, <Product: Product object 
(11)>]> 





6.4 多 表 查 询 


在 6.3 节 我 们 了 解 到 数据 表 的 读 写 操作 ， 但 仅仅 局 限 在 单个 数据 表 的 操作 。 在 日 
常 的 开发 中 ， 常 常 需要 对 多 个 数据 表 同 时 进行 数据 查询 。 多 个 数据 表 查 询 需要 数据 表 
之 间 建 立 了 表 关 系 才 得 以 实现 。 

一 对 多 或 一 对 一 的 表 关系 是 通过 外 键 实现 关联 的 ， 而 多 表 查 询 分 为 正 向 查询 和 
反 向 查询 。 以 模型 Product 和 Type 为 例 : 


@ ”如 果 查询 对 象 的 主体 是 模型 Type， 要 查询 模型 Type 的 数据 ， 那 么 该 查询 称 
为 正 向 查询 。 

@ “如果 查 询 对 象 的 主体 是 模型 Type， 要 通过 模型 Type 查询 模型 Product 的 数据 ， 
那么 该 查询 称 为 反 向 查询 。 


无 论 是 正 向 查询 还 是 反 向 查询 ， 两 者 的 实现 方法 大 致 相同 ， 代 码 如 下 : 


>>> 七 = Type.objects.filter (Product__ id=11) 
# 正 向 查询 

>>> 七 

<QuerySet [<Type: Type object (1)>]> 

>>> 七 [0] .type_name 


手机， 

# 反 向 查询 

>>> 七 [0] .product set.values('name') 

<QuerySet [{'name': ' 荣 耀 V10'}，{'name': 'HUAWEI nova 2s'}，{'name': ' 华 


为 荣耀 V9'}，{'name' : ， 华为 荣 焰 V9'}，1{'name' : ' 华为 荣耀 V9'}]> 


从 上 面 的 代码 分 析 ， 因 为 正 向 查询 的 查询 对 象 主体 和 查询 的 数据 都 来 自 于 模 
型 Type， 因 此 正 向 查询 在 数据 库 中 只 执行 了 一 次 SQL 查询 。 而 反 向 查询 通过 t[0]. 
product_set.values('name') 来 获取 模型 Product 的 数据 ， 因 此 反 向 查询 执行 了 两 次 
SQL 查询 ， 首 先 查 询 模 型 Type 的 数据 ， 然 后 根据 第 一 次 查询 的 结果 再 查询 与 模型 
Product 相互 关联 的 数据 。 
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为 了 减少 反 向 查询 的 查询 次 数 ， 我 们 可 以 使 用 select related 方法 实现 ， 该 方法 只 


执行 一 次 SQL 查询 就 能 达到 反 向 查询 的 效果 。select related 使 用 方法 如 下 : 


type 


name 


# 查询 模型 product 的 字段 name 和 模型 Type 的 字段 type_name 

# 等 同 于 SQL: SELECT name,type name FROM index product INNER JOIN index_ 
ON (type id = id) 

>>> Product.objects.select related('type') .values('name', 'type type 
和 

# 输出 sQL 查询 语句 

>>> print (p.query) 


# 查询 两 个 模型 的 全 部 数据 

# SELECT * FROM index product INNER JOIN index type ON (type_id 
>>> Product.objects.select related('type') .all() 

# 输出 SQL 查询 语句 

>>> print (p.query) 


id) 


# 获取 两 个 模型 的 数据 ， 以 模型 eroduct 的 id 大 于 8 为 查询 条 件 
# SELECT * FROM index product INNER JOIN index type ON (type_id 


id) 


WHERE index product.id>8 


>>> Product.objects.select related('type') .filter(id gt=8) 
# 输出 SQL 查询 语句 
>>> print (p.query) 


# 获取 两 模型 数据 ， 以 模型 Type 的 type_name 字段 等 于 手机 为 查询 条 件 
# SELECT * FROM index product INNER JOIN index _ type ON (type_id 


id) 


WHERE index type.type name = ' 手 机 ' 


起 于 开放 
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>>> Product.objects.select related('type') .filter (type type_name=' 手机 ') . 
) 

# 输出 SQL 查询 语句 

>>> print (p.query) 

# 输出 模型 Product 信息 

>>> p[0] 

<Product: Product object (1)> 

# 输出 模型 Product 所 关联 模型 Type 的 信息 
>>> p[0] .type 

<Type: Type object (1)> 

>>> p[0] .type.type_name 

! 手 机 ' 


select_related 的 使 用 说 明 如 下 : 

e ”以 模型 Product 作为 查询 对 象 主体 ， 当 然 也 可 以 使 用 模型 Type， 只 要 两 表 之 间 
有 外 键 关联 即 可 。 

@ 设置 select related 的 参数 值 为 “type”, 该 参数 值 是 模型 Product 定 义 的 type 字 段 。 
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ee 如 果 在 查询 过 程 中 需要 使 用 另 一 个 数据 表 的 字段 ， 可 以 使 用 “外 键 。 字段 名 ” 
来 指向 该 表 的 字段 。 如 type type name 代表 由 模型 Product 的 外 键 type 指向 
模型 Type 的 字段 type_name, type 代表 模型 Product 的 外 键 type， 双 下 画 线 “″ ?” 
代表 连接 符 ，type_name 是 模型 Type 的 字段 。 


除 此 之 外 ，select_related 还 可 以 支持 三 个 或 三 个 以 上 的 数据 表 同 时 查询 ， 以 下 面 
的 例子 进行 说 明 。 


# models .py 定义 
from django.db import models 


# 省 份 信息 表 
class Province (models.Model): 
name = models.CharField (max length=10) 


# 城市 信息 表 
class City (models.Model): 
name = models.CharField (max length=5) 
province = models.ForeignKey (Province, on delete=models .CASCADE) 


# 人 物 信息 表 
class Person (models.Model) : 
name = models.CharField(max length=10) 
living = models.ForeignKey (City, on delete=models.CASCADE) 


在 上 述 模型 中 ， 模 型 Person 通过 外 键 living 关联 模型 City， 模 型 City 通过 外 键 
province 关联 模型 Province， 从 而 使 三 个 模型 形成 一 种 递 进 关系 。 
例如 查询 张 三 现在 所 居住 的 省 份 ， 首 先 通过 模型 Person 和 模型 City 查 出 张 三 所 


居住 的 城市 ， 然 后 通过 模型 City 和 模型 Province 查询 当前 城市 所 属 的 省 份 。 因 此 ， 
select related 的 实现 方法 如 下 : 


p = Person.objects.select related('living province') .get (name=' 张 三 ') 
p.living.province 


在 上 述 例 子 可 以 发 现 ， 通 过 设置 select related 的 参数 值 即 可 实现 三 个 或 三 个 以 上 
的 多 表 查 询 。 例 子 中 的 参数 值 为 living_province， 参 数值 说 明 如 下 : 

e “living 是 模型 Person 的 字段 ， 该 字段 指向 模型 City。 

e ”province 是 模型 City 的 字段 ， 该 字段 指向 模型 Province。 

e ”两 个 字段 之 间 使 用 双 下 画 线 连接 并 且 两 个 字段 都 是 指向 另 一 个 模型 的 ， 这 说 
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明 在 查询 过 程 中 ， 模 型 Person 的 字段 living 指向 模型 City， 再 从 模型 City 的 
字段 province 指向 模型 Province， 从 而 实现 三 个 或 三 个 以 上 的 多 表 查 询 。 


除了 上 面 所 讲述 的 例子 之 外 ，Diango 的 ORM 框架 还 提供 很 多 API 方法 ， 可 以 满 
足 开发 中 各 种 复杂 的 需求 ， 由 于 篇 幅 有 限 ， 就 不 再 一 一 介绍 了 ， 有 兴趣 的 读者 可 在 网 
上 查阅 资料 。 


6.5 本 章 小 结 


Django 对 各 种 数据 库 提供 了 很 好 的 支持 ， 包 括 : PostgreSQL、MySQL、SQLite 
和 Oracle， 而 且 为 这 些 数据 库 提 供 了 统一 的 调用 API， 这 些 API 统称 为 ORM 框架 。 
通过 使 用 Django 内 置 的 ORM 框架 可 以 实现 数据 库 连 接 和 读 写 操作 。 

在 Django 中 ， 虚 拟 对 象 数据 库 也 称 为 模型 。 通 过 模型 实现 对 目标 数据 库 的 读 写 
操作 ， 实 现 方法 如 下 : 





(1) 配置 目标 数据 库 信 息 ， 主 要 在 settings.py 中 设置 数据 库 信 息 ， 具 体 配 置 步 
又 可 看 2.4 节 。 

(2) 构建 虚拟 对 象 数 据 库 ， 在 App 的 models.py 文件 中 以 类 的 形式 定义 模型 。 

(3) 通过 模型 在 目标 数据 库 中 创建 相应 的 数据 表 。 

(4) 在 视图 函数 中 通过 对 模型 操作 实现 目标 数据 库 的 读 写 操作 。 


一 个 模型 对 应 目标 数据 库 的 一 个 数据 表 ， 但 我 们 知道 ， 每 个 数据 表 之 间 是 可 以 存 
在 关联 的 ， 表 与 表 之 间 有 三 种 关系 : 一 对 一 、 一 对 多 和 多 对 多 ， 其 说 明 如 下 : 


e 一 对 一 存在 于 两 个 数据 表 中 ， 第 一 个 表 的 某 一 行 数据 只 与 第 二 个 表 的 某 一 行 
数据 相关 ， 同 时 第 二 个 表 的 某 一 行 数据 也 只 与 第 一 个 表 的 某 一 行 数据 相关 ， 
这 种 表 关 系 被 称 为 一 对 一 关系 。 

日 “一 对 多 存在 于 两 个 或 两 个 以 上 的 数据 表 中 ， 第 一 个 表 的 数据 可 以 与 第 二 个 表 
的 一 到 多 行 数 据 进行 关联 ， 但 是 第 二 个 表 的 每 一 行 数据 只 能 与 第 一 个 表 的 某 
一 行进 行 关联 。 

e 多 对 多 存在 于 两 个 或 两 个 以 上 的 数据 表 中 ， 第 一 个 表 的 菜 一 行 数据 可 以 与 第 
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二 个 表 的 一 到 多 行 数 据 进行 关联 ， 同 时 在 第 二 个 表 中 的 某 一 行 数据 也 可 以 与 
第 一 个 表 的 一 到 多 行 数 据 进 行 关联 。 


区 分 查询 条 件 get 和 filter 的 差异 ， 两 者 区 别 如 下 。 


查询 条 件 get: 查询 字段 必须 是 主键 或 者 唯一 约束 的 字段 ， 并 且 查询 的 数据 必 
须 存在 ， 如 果 查 询 的 字段 有 重复 值 或 者 查询 的 数据 不 存在 ， 程 序 都 会 抛 出 异 
常 信息 。 

查询 条 件 filter: 查询 字段 没有 限制 ， 只 要 该 字段 是 数据 表 的 某 一 字段 即 可 。 
查询 结果 以 列表 的 形式 返回 ， 如 果 查 询 结果 为 空 (查询 的 数据 在 数据 库 中 找 
不 到 ) ， 就 返回 空 列表 。 


在 多 表 查 询 中 ， 应 掌握 select related 的 使 用 方法 。 以 模型 Product 和 Type 为 例 ， 
说 明 如 下 : 


以 模型 Product 作为 查询 对 象 主体 ， 当 然 也 可 以 使 用 模型 Type， 只 要 两 表 之 
间 有 外 键 关联 即 可 。 

设置 select_related 的 参数 值 为 “type”， 该 参数 值 是 模型 Product 定义 的 type 
字段 。 

如 果 在 查询 过 程 中 需要 使 用 另 一 个 数据 表 的 字段 ， 可 以 使 用 “外 键 “字段 名 ” 
来 指向 该 表 的 字段 。 如 type_type_name 代表 由 模型 Product 的 外 键 type 指向 
模型 Type 的 字段 type_name, type 代表 模型 Product 的 外 键 type, 双 下 画 线 “″ _ ? 
代表 连接 符 ，type_name 是 模型 Type 的 字段 。 
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表单 是 搜集 用 户 数据 信息 的 各 种 表单 元 素 的 集合 , 作用 是 实现 网 页 上 的 数据 交互 ， 
用 户 在 网 站 输入 数据 信息 ， 然 后 提交 到 网 站 服务 器 端 进行 处 理 〈 如 数据 录入 和 用 户 登 
录 、 注 册 等 ) 。 

用 户 表 单 是 Web 开发 的 一 项 基本 功能 ，Django 的 表单 功能 由 Form 类 实现 ， 主 要 
分 为 两 种 ，django.forms.Form 和 django.forms.ModelForm。 前 者 是 一 个 基础 的 表单 功能 ， 
后 者 是 在 前 者 的 基础 上 结合 模型 所 生成 的 数据 表单 。 


7.1 初 识 表单 





传统 的 表单 生成 方式 是 在 模板 文件 中 编写 HTML 代码 实现 ， 在 HTML 语言 中 ， 
表单 由 <form> 标签 实现 。 表 单 生成 方式 如 下 : 
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<!DOCTYPE html> 

<html> 

<body> 

# 表单 

<form action="" method="post"> 

First name:<br> 

<input type="text" name="firstname" value="Mickey"> 
<br> 

Last name:<br> 

<input type="text" name="lastname" value="Mouse"> 
<br><br> 

<input type="submit" value="Submit"> 

</form> 

# 表单 

</body> 

</html> 


一 个 完整 的 表单 主要 有 4 个 组 成 部 分 : 提交 地 址 、 请 求 方式 、 元 素 控件 和 提交 按 
钮 。 其 说 明 如 下 : 


e 提交 地 址 用 于 设置 用 户 提交 的 表单 数据 应 由 哪个 URL 接收 和 处 理 ， 由 控件 
<form> 的 属性 action 决定 。 当 用 户 向 服务 器 提交 数据 时 ， 若 属性 action 为 空 ， 
则 提交 的 数据 应 由 当前 的 URL 来 接收 和 处 理 ， 否 则 网 页 会 跳 转 到 属性 action 
所 指向 的 URL 地 址 。 

。 请求 方 式 用 于 设置 表单 的 提交 方式 ， 通 常 是 GET 请 求 或 POST 请 求 ， 由 控件 
<form> 的 属性 method 决定 。 

e@ 元素 控件 是 供用 户 输入 数据 信息 的 输入 框 。 由 HTML 的 <input> 控件 实现 ， 
其 控件 属性 type 用 于 设置 输入 框 的 类 型 ， 常 用 的 输入 框 类 型 有 文本 框 、 下 拉 
框 和 复 选 框 等 。 

e ”提交 按钮 供用 户 提交 数据 到 服务 器 ， 该 按钮 也 是 由 HIML 的 <input> 控件 实 
现 的 。 但 该 按钮 具有 一 定 的 特殊 性 ， 因 此 不 归纳 到 元 素 控件 的 范围 内 。 


在 模板 文件 中 ， 直 接 编写 表单 是 一 种 较为 简单 的 实现 方式 ， 如 果 表 单元 素 较 多 ， 
会 在 无 形 之 中 增加 模板 的 代码 量 ， 这 样 对 日 后 的 维护 和 更 新 造成 极 大 的 不 便 。 为 了 简 
化 表单 的 实现 过 程 和 提高 表单 的 灵活 性 ，Django 提供 了 完善 的 表单 功能 。 在 讲解 表单 
使 用 方法 之 前 ， 我 们 对 MyDjango 的 目录 做 了 细微 的 调整 ， 如 图 7-1 所 示 。 
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> Pi migrations 

> Pstatic 

Y Dtemplates 
访 data_form.html 
访 indexhtml 














图 7-1 MyDjango 目录 架构 


在 MyDjango 的 index 中 添加 了 空白 文件 form.py， 该 文件 主要 用 于 编写 表单 的 
实现 功能 ， 文 件 夹 可 自行 命名 ; 同时 在 文件 夹 templates 中 添加 模板 文件 data_form. 
html， 该 文件 用 于 将 表单 的 数据 显示 到 网 页 上 。 最 后 在 文件 form.py、views.py 和 
data_form.html 中 分 别 添加 以 下 代码 : 


# form.py 代码 ， 定 义 ProductForm 表单 对 象 
from django import forms 
from .models import * 
class ProductForm(forms.Form): 
name = forms.CharField (max_length=20，label=' 名 字 ',) 
weight = forms.CharField(max length=50, label=" 重量 ') 
size = forms.CharField(max length=50, label=" 尺寸 ') 
# 设置 下 拉 框 的 值 
choices list = [(i+tl,v['type name']) for i,v in enumerate (Type. 
objects.values('type name'))] 
type = forms.ChoiceField(choices=choices_list，label=' 产品 类 型 ') 


# views .py 代码 ， 将 表单 ProductForm 实例 化 并 将 其 传递 到 模板 中 生成 网 页 内 容 
from django.shortcuts import render 
from .form import * 
def index(request): 
product = ProductEorm() 





return render(request, 'data form.html',locals()) 


# data_form.html 代码 ， 将 表单 对 象 的 内 容 显 示 在 网 页 上 
<!1DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="UTF-8"> 
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<title>Title</title> 


</head> 
<body> 
{% if product.errors $} 
<p> 
数据 出 错 啦 ， 错 误 信息 : {{ product.errors }}. 
</p> 
{$$ else $} 
<form action="" method="post"> 
{% csrf token %} 
<table> 
{{ product.as table }} 
</table> 
<input type="submit" value=" 提交 "> 
</form> 
{% endif %} 
</body> 
</html> 





上 述 代 码 演示 了 Django 内 置 表 单 功能 的 使 用 方法 ， 主 要 由 form.py、views.py 和 


data_form.html 共同 实现 ， 实 现 说 明 如 下 : 


(1) 在 form.py 中 定义 表单 ProductForm， 表 单 以 类 的 形式 表示 。 在 表单 中 定义 
了 不 同类 型 的 类 属性 ， 这 些 属性 在 表单 中 称 为 表单 字段 ， 每 个 表单 字段 代表 HTML 





里 的 一 个 控件 ， 这 是 表单 的 基本 组 成 单位 。 





(2) 在 views.py 中 导入 form.py 所 定义 的 ProductForm 类 ， 在 视图 函数 index 





html。 


中 对 ProductForm 实例 化 生成 对 象 product， 再 将 对 象 product 传递 给 模板 data_form. 


(3) 模 板 data_form.html 将 对 象 product 以 HTML 的 <table> 的 形式 展现 在 网 页 上 ， 


如 图 7-2 所 示 。 








CG |© 127.0.0.1:8000 


名 字 [| | 
重量 : ] 
尺寸: ] 
产品 类 型 :| 手机 











旧 








图 7-2 运行 结果 
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7.2 表单 的 定义 


从 7.1 节 的 例子 发 现 ，Django 的 表单 功能 主要 是 通过 定义 表单 类 ， 再 由 类 的 实 
例 化 生成 HIML 的 表单 元 素 控件 ， 这 样 可 以 在 模板 中 减少 HIML 的 硬 编码 。 每 个 
HTML 的 表单 元 素 控件 由 表单 字段 来 决定 ， 代 码 如 下 : 





# 表单 类 ProductForm 的 表单 字段 name 

name = forms.CharField (max length=20，1label=' 名 字 ',) 

# 表单 字段 name 所 生成 的 HTML 元 素 控 件 

<tr> 

<th><label for="id name"> 名 字 :</label></th> 

<td><input type="text" name="name" id="id name" required maxlength="20" 
/></td> 

</tr> 


从 表单 字段 转换 HTML 元 素 控件 可 以 发 现 : 


。 字段 name 的 参数 label 将 转换 成 HTML 的 标签 <label>。 


。 字段 name 的 forms.CharField 类 型 转换 成 HIML 的 <input type="text"> 控件 ， 
标签 <input> 是 一 个 输入 框 控 件 ，type="text" 代表 当前 输入 框 为 文本 输入 框 ， 
参数 type 用 于 设置 输入 框 的 类 型 。 


e 字段 name 的 命名 转换 成 <input> 控件 的 参数 name， 表 单字 段 的 参数 max_ 
length 将 转换 成 <input> 控件 的 参数 required maxlength。 


除了 上 述 表 单字 段 外 ，Django 还 提供 多 种 内 置 的 表单 字段 ， 如 表 7-1 所 示 。 
表 7-1 Django 内 置 的 表单 字段 











字段 说 明 
BooleanField 复 选 框 ， 如 果 字 段 带 有 required=True， 复 选 框 被 勾 选 上 
CharField 文本 框 ， 参 数 max length 和 min length 分 别 设置 输入 长 度 
ChoiceField 下 拉 框 ， 参 数 choices 设 置 数据 内 容 
与 ChoiceField 相 似 ， 但 比 ChoiceField 多 出 参数 coerce 和 empty_ 
TypedChoiceField value， 分 别 代表 强制 转换 数据 类 型 和 用 于 表示 空 值 ， 默 认为 空 字 符 
串 
Da 文本 框 ， 具 有 验证 日 期 格式 的 功能 ， 参 数 input formats 设 置 日 期 格 
ateField 式 
文本 框 ， 验 证 输入 数据 是 否 为 合法 的 邮箱 地 址 。 可 选 参数 为 max_ 
EmailField length 和 min_ length 
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文件 上 传 功能 ， 参 数 max_length 和 allow_empty_file 分 别 用 于 设置 文 
件 名 的 最 大 长 度 和 文件 内 容 是 否 为 空 

在 特定 的 目录 选择 并 上 传 文件 ， 参 数 path 是 必需 参数 ， 参 数 
TIectrsive、match、allow_files 和 allow_folders 为 可 选 参数 

验证 数据 是 否 为 浮 点 数 


FileField 





FilePathField 





FloatField 






















TmageField 验证 文件 是 否 为 Pilow 库 可 识别 的 图 像 格 式 

IntegerField 验证 数据 是 否 为 整 型 

验证 数据 是 否 为 有 效 数值 

验证 数据 是 否 只 包括 字母 、 数 字 、 下 画 线 及 连 字符 

验证 数据 是 否 为 datetime.time 或 指定 特定 时 间 格 式 的 字符 串 


URLField 





验证 数据 是 否 为 有 效 的 URL 地 址 





从 表 7-1 可 以 看 出 ， 表 单字 段 除 了 转换 HTML 控件 之 外 ， 还 具有 一 定 的 数据 格式 
规范 ， 数 据 格式 规范 主要 由 字段 类 型 和 字段 参数 共同 实现 。 每 个 不 同类 型 的 表单 字段 
都 有 一 些 自己 特殊 的 参数 ， 但 每 个 表单 字段 都 具有 表 7-2 所 示 的 共同 参数 。 


表 7-2 表单 字段 的 共同 参数 


参数 说 明 
Required 输入 数据 是 否 为 空 ， 默 认 值 为 True 
Widget 设置 HTML 控件 的 样式 
Label 用 于 生成 Label 标 签 或 显示 内 容 
Initial 设置 初始 值 
help text 设置 帮助 提示 信息 
设置 错误 信息 ， 以 字典 格式 表示 : {'required': ' 不 能 为 空 '， 
error_messages vinvalid": ,格式 错误 


bw Tn al 值 为 True/False， 是 否 在 当前 插件 后 面 再 加 一 个 隐藏 的 且 具 有 默认 值 
一 一 的 插件 (可 用 于 检验 两 次 输入 值 是 否 一 致 ) 











Validators 自 定义 数据 验证 规则 。 以 列表 格式 表示 ， 列 表 元 素 为 函数 名 
Localize 值 为 True/False， 是 否 支持 本 地 化 ， 如 不 同时 区 显示 相应 的 时 间 
Disabled 值 为 True/False， 是 否 可 以 编辑 

label suffix Label 内 容 后 级 ， 在 Label 后 添加 内 容 





根据 表 7-2 的 参数 说 明 ， 我 们 对 form.py 的 表单 ProductForm 的 字段 进行 优化 ， 
代码 如 下 : 


from django import forms 
from .models import * 
from django.core.exceptions import ValidationError 
# 自 定义 数据 验证 函数 
def weight validate (Value) : 
if not str(value) .isdigit(): 
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raise ValidationError(' 请 输入 正确 的 重量 ') 


# 表单 


class ProductForm(forms.Form): 


# 设置 错误 信息 并 设置 样式 
name = forms.CharField (max length=20，1label=' 名 字 '， 
widget=forms .widgets- 


TextInput (attrs={'class': ‘'c1'}), 


将 


error messages={ 'Iequired': " 名 字 不 能 为 


# 使 用 自 定 义 数 据 验证 函数 
weight = forms .CharField(max _ length=50，1label=' 重 


量 ',validators=[weight validate]) 


size = forms.CharField(max length=50，1label=' 尺寸 ') 
# 获取 数据 库 数据 


choices list = [(i+tl,v['type name']) for i,v in enumerate (Type. 


objects.values('type name'))] 


# 设置 css 样式 


type = forms.ChoiceField (widget=forms.widgets.Select (attrs={'class': 


'type', 'size':'4'}),choices=choices list,label=" 产品 类 型 ') 


优化 的 代码 分 别 使 用 了 参数 widget、label、error messages 和 validators， 这 4 个 
参数 是 实际 开发 中 常用 的 参数 ， 参 数 说 明 如 下 : 


参数 widget 是 一 个 forms.widgets 对 象 ， 其 作用 是 设置 表单 字段 的 CSS 样式 。 
widget 的 对 象 类 型 应 与 表单 字段 类 型 相符 合 ， 如 果 字 段 类 型 为 CharField 和 
widget 的 对 象 类 型 为 forms.widgets.TextInput， 这 两 者 的 含义 与 作用 是 一 臻 
的 ， 都 代表 文本 输入 框 ; 如 果 字段 类 型 为 ChoiceField 和 widget 的 对 象 类 型 为 
forms.widgets.TextInput 相 组 合 ， 前 者 是 下 拉 选 择 框 ， 后 者 是 文本 输入 框 ， 那 
么 在 网 页 上 就 会 优先 显示 为 文本 输入 框 。 

参数 label 会 转换 成 HTML 的 标签 <label>， 作 用 是 对 控件 的 描述 和 命名 ， 方 
便 用 户 理解 控件 的 作用 与 含义 。 

参数 error_ messages 用 于 设置 数据 验证 失败 后 的 错误 信息 ， 参 数值 以 字典 的 形 
式 表 示 ， 字 典 的 键 为 表单 字段 的 参数 名 ， 字 典 的 值 为 错误 信息 。 

参数 validators 用 于 自 定 义 数 据 验证 函数 ， 当 用 户 提交 表单 数据 后 ， 首 先 执行 
自 定义 的 验证 函数 ， 当 数据 验证 失败 后 ， 会 抛 出 自 定义 的 异常 信息 。 所 以 ， 
字段 中 设置 了 参数 validators， 就 无 须 设置 参数 error messages， 因 为 数据 验证 
已 由 参数 validators 优先 处 理 。 


为 了 进一步 验证 优化 后 的 表单 是 否 正确 运行 ， 我 们 对 views.py 的 视图 函数 index 
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代码 进行 优化 ， 代 码 如 下 : 


# views .py 代码 ， 对 表单 提交 的 数据 进行 处 理 


from django .shortcuts import render 


from django .http import HttpResponse 


from .form import * 


def index(request): 


# GET 请 求 
if request.method == "GET': 
product = ProductForm() 
return render(request, 'data form.html',locals()) 
# POST 请 求 
else: 
product = ProductForm(request.POST) 
if product.is valid(): 
# 获取 网 页 控件 name 的 数据 
# 方法 一 
name = product['name'] 
# 方法 二 
# cleaned data 将 控件 name 的 数据 进行 清洗 ， 转 换 成 Python 数据 类 型 
cname = product.cleaned data['name'] 
return HttpResponse(' 提交 成 功 ') 
else: 
# 将 错误 信息 输出 ，error_msg 是 将 错误 信息 以 json 格式 输出 
error msg = product.errors.as json() 
print (error msg) 
return render(request, 'data form.html', locals()) 


上 述 代 码 是 对 views.py 的 视图 函数 index 进行 优化 ， 优 化 说 明 如 下 : 


首先 判断 用 户 的 请 求 方式 ， 不 同 的 请 求 方式 执行 不 同 的 程序 处 理 。 函 数 index 
分 别 对 GET 和 POST 请 求 做 了 不 同 的 响应 处 理 。 

用 户 在 浏览 器 中 访问 http://127.0.0.1:8000/， 等 同 于 向 MyDjango 发 送 一 个 GET 
请 求 ， 函 数 index 将 表单 ProductForm 实例 化 并 传递 给 模板 ， 由 模板 引擎 生成 
HTML 表单 返回 给 用 户 。 

当 用 户 在 网 页 上 输入 相关 信息 后 单 击 “提交 ”按钮 ， 等 同 于 向 MyDjango 发 
送 一 个 POST 请求， 函数 index 首先 获取 表单 数据 对 象 product， 然 后 由 is_ 
Valid() 对 数据 对 象 product 进行 数据 验证 。 

如 果 验 证 成 功 ， 可 以 使 用 product['name'] 或 productcleaned_data['name'] 方 
法 来 获取 用 户 在 某 个 控件 上 的 输入 值 。 只 要 将 获取 到 的 输入 值 和 模型 相互 使 
用 ， 就 可 以 实现 表单 与 模型 的 信息 交互 。 
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@。 如果 验证 失败 ， 使 用 errors.as json() 方法 获取 验证 失败 的 信息 ， 然 后 将 验证 失 
败 的 信息 通过 模板 返回 给 用 户 。 


从 上 述 例子 发 现 ， 模 板 data_form.html 的 表单 是 使 用 HIML 的 <table> 标签 展现 


在 网 页 上 ， 除 此 之 外 ， 表 单 还 可 以 使 用 其 他 HTML 标签 展现 ， 只 需 将 模板 data_form. 
html 的 对 象 product 使 用 以 下 方法 即 可 生成 其 他 HIML 标签 : 


# 将 表单 生成 HTML 的 ul 标签 

{{ product.as ul }} 

# 将 表单 生成 HTML 的 p 标签 

{{ product.as p }} 

# 生成 单个 HTML 元 素 控件 

{{ product.type }} 

# 获取 表单 字段 的 参数 Iable 属性 值 
{{ product.type.label }} 


7.3 模型 与 表单 


我 们 知道 Django 的 表单 分 为 两 种 : django.forms.Form 和 django.forms. 


ModelForm。 前 者 是 一 个 基础 的 表单 功能 ， 后 者 是 在 前 者 的 基础 上 结合 模型 所 生成 
的 数据 表单 。 数 据 表单 是 将 模型 的 字段 转换 成 表单 的 字段 ， 再 从 表单 的 字段 生成 
HTML 的 元 素 控 件 ， 这 是 日 常 开发 中 常用 的 表单 之 一 。 本 节 通 过 讲解 表单 功能 模块 
ModelForm 实现 表单 数据 与 模型 数据 之 间 的 交互 开发 。 


首先 在 文件 form.py 中 定义 表单 ProductModelForm， 该 表单 继承 自 父 类 forms. 


ModelForm。 其 代码 如 下 : 
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from django import forms 
from .models import * 
from django.core.exceptions import ValidationError 
# 数据 库 表单 
class ProductModelForm(forms.ModelForm): 
# 添加 模型 外 的 表单 字段 
productId = forms.CharField(max _ length=20，label="' 产品 序号 ') 
# 模型 与 表单 设置 
class Meta: 
# 绑 定 模型 
model = Product 


# fields 属性 用 于 设置 转换 字段 ，' ”all ' 是 将 全 部 模型 字段 转换 成 表单 字段 
# fields = ' all _' 
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fields = ['name','weight','size','type'] 
# exclude 用 于 禁止 模型 字段 转换 表单 字段 
exclude = [] 
# labels 设置 HTML 元 素 控件 的 1abel 标签 
labels = { 

'name' : ' 产品 名 称 '， 

'weight': ' 重量 '， 

rsize': 尺寸 


'type' : ' 产品 类 型 ' 
} 
# 定义 widgets， 设 置 表单 字段 的 css 样式 
widgets = { 
"name' : forms .widgets -TextInput (attrs={'class': "cl'})v 


} 
# 定义 字段 的 类 型 ， 一 般 情况 下 模型 的 字段 会 自动 转换 成 表单 字段 
field classes = { 

"name' : forms .CharField 


} 

# 帮助 提示 信息 

help texts = { 
'name': '' 


} 
# 自 定义 错误 信息 
error messages = { 
# all _ 设 置 全 部 错误 信息 
'_all ': {'required':' 请 输入 内 容 '， 
"invalid' : ' 请 检查 输入 内 容 '}， 
# 设置 某 个 字段 的 错误 信息 
'weight': {'required':' 请 输入 重量 数值 '， 
'invalid' : ' 请 检查 数值 是 否 正确 ' } 
} 


# 自 定义 表单 字段 weight 的 数据 清洗 
def clean weight (self): 
# 获取 字段 weight 的 值 
data = self.cleaned data['weight'] 
return data+'g' 


上 述 代码 中 , 表单 类 ProductModelForm 可 分 为 三 大 部 分 : 添加 模型 外 的 表单 字段 、 
模型 与 表单 设置 和 自 定 义 表单 字段 weight 的 数据 清洗 函数 ， 说 明 如 下 : 


。 ”添加 模型 外 的 表单 字段 是 在 模型 已 有 的 字段 下 添加 额外 的 表单 字段 。 

日 “模型 与 表单 设置 是 将 模型 的 字段 转换 成 表单 字段 ， 由 类 Meta 的 属性 实现 两 者 
的 字段 转换 。 

。 自 定义 表单 字段 weight 的 数据 清洗 函数 只 适用 于 字段 weight 的 数据 清洗 。 
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综 上 所 述 ， 模 型 字段 转换 成 表单 字段 主要 在 类 Meta 中 实现 。 在 类 Meta 中 ， 其 属 
性 说 明 如 表 7-3 所 示 。 


表 7-3 类 Meta 的 属性 及 说 明 











属性 说 明 
Model 必需 属性 ， 用 于 绑 定 Model 对 象 
必需 属性 ， 设 置 模型 内 哪些 字段 转换 成 表单 字段 。 属 性 值 为 '，all “代表 
Fields 整个 模型 的 字段 ， 若 设置 一 个 或 多 个 ， 使 用 列表 或 元 组 的 数据 格式 表示 ， 
列表 或 元 组 里 的 元 素 是 模型 的 字段 名 





可 选 属性 ， 与 fields 相 反 ， 禁 止 模型 内 哪些 字段 转换 成 表单 字段 。 属 性 值 
以 列表 或 元 组 表示 ， 若 设置 了 该 属性 ， 则 属性 fields 可 以 不 用 设置 


可 选 属性 ， 设 置 表单 字段 里 的 参数 label。 属 性 值 以 字典 表示 ， 字 典 里 的 键 
是 模型 的 字段 
可 
可 


Exclude 


Labels 


Widgets 选 属性 ， 设 置 表 单字 段 里 的 参数 widget 


Se [ 选 属性 ， 将 模型 的 字段 类 型 重新 定义 为 表单 字段 类 型 ， 默 认 情 况 下 ， 模 
下 型 字段 类 型 会 自动 转换 为 表单 字段 类 型 


可 选 属性 ， 设 置 表单 字段 里 的 参数 help_text 
选 属性 ， 设 置 表 单字 段 里 的 参数 error_ messages 


help_texts 











引 | 局 


elITOT_ Messages 





值得 注意 的 是 ， 一 些 较 为 特殊 的 模型 字段 在 转换 表单 时 会 有 不 同 的 处 理 方式 。 例 
如 模型 字段 的 类 型 为 AutoField， 该 字段 在 表单 中 不 存在 对 应 的 表单 字段 ;模型 字段 类 
型 为 ForeignKey 和 ManyToManyField， 在 表单 中 对 应 的 表单 字段 为 ModelChoiceField 
和 ModelMultipleChoiceField。 


自 定义 表单 字段 weight 的 数据 清洗 函数 是 在 视图 函数 中 使 用 cleaned_data 方法 时 ， 
首先 判断 当前 清洗 的 表单 字段 是 否 已 定义 数据 清洗 函数 。 例 如 上 述 的 clean_ weight 函 
数 ， 在 清洗 表单 字段 weight 的 数据 时 会 自动 执行 该 自 定义 函数 。 在 自 定 义 数 据 清洗 函 
数 时 ， 必 须 以 “clean_ 字 段 名 ”的 格式 作为 函数 名 ， 而 且 函 数 必 须 有 retum 返回 值 。 
如 果 在 函数 中 设置 ValidationError 了 异常 抛 出 ， 那 么 该 函数 可 视 为 带 有 数据 验证 的 清 
洗 函 数 。 


7.4 数据 表单 的 使 用 


7.3 节 通 过 定义 表单 类 ProductModelForm 将 模型 Product 与 表单 相互 结合 起 来 ， 
本 节 将 通过 表单 类 ProductModelForm 在 网 页 上 生成 HTML 表单 。 我 们 沿用 前 面 的 模 
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板 data form.html， 在 MyDjango 的 urlspy 和 viewspy 中 分 别 定义 新 的 URL 地 址 和 
视图 函数 ， 代 码 如 下 : 


类 型 


# urls.py 的 URL 地址 信息 
from django.urls import path 
from . import views 
urlpatterns = [ 
# 首页 的 URL 
path('', views.index), 
# 数据 库 表单 
path('<int:id>.html', views.model index), 


] 


# views .py 的 视图 函数 model index 
from django.shortcuts import render 
from django.http import HttpResponse 
from .form import * 
def model index(request, id): 
if request.method == 'GET': 
instance = Product.objects .filter (id=id) 
# 判断 数据 是 否 存在 
if instance: 
product = ProductModelForm(instance=instance[0]) 
else: 
product = ProductModelForm() 
return render(request, 'data form.html', locals()) 
else: 
product = ProductModelForm (request .POST) 
if product.is valid(): 


# 获取 weight 的 数据 ， 并 通过 clean_weight 进行 清洗 ， 转 换 成 python 数据 


weight = product.cleaned data['weight'] 

# 数据 保存 方法 一 

# 直接 将 数据 保存 到 数据 库 

# product.save() 

# 数据 保存 方法 二 

# save 方法 设置 commit=False， 将 生成 数据 库 对 象 product_db， 然 后 对 该 


对 象 的 属性 值 修改 并 保存 


product db = product -save (commit=False) 
product_db.name = ' 我 的 iPhone' 
product db.save() 


# 数据 保存 方法 三 
# save_m2m() 方法 用 于 保存 ManyToMany 的 数据 模型 


# product.save m2m() 


return HttpResponse(' 提交 成 功 !weight 清洗 后 的 数据 为 : ' +weight) 


else: 
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# 将 错误 信息 输出 ，error_msg 是 将 错误 信息 以 json 格式 输出 
error msg = product.errors.as json() 

print (error msg) 

return render(request, 'data form.html', locals()) 


函数 model index 的 处 理 逻 辑 和 7.2 节 的 函数 index 大 臻 相同， 说明 如 下 : 


首先 判断 用 户 的 请 求 方式 ， 不 同 的 请 求 方 式 执行 不 同 的 处 理 程 序 。 代 码 分 别 
对 GET 和 POST 请 求 做 了 不 同 的 响应 处 理 。 
若 当 前 请 求 为 GET 请 求 ， 函 数 根据 URL 传递 的 变量 id 来 查找 模型 
Product 的 数据 ， 如 果 数 据 存在 ， 模 型 的 数据 以 参数 的 形式 传递 给 表单 
ProductModelForm 的 参数 instance， 在 生成 网 页 时 ， 模 型 数据 会 填充 到 对 应 的 
0 如 图 7-3 所 示 。 

当前 请 求 为 POST 请 求 ， 函 数 首 先 对 表单 数据 进行 验证 ， 若 验证 失败 ， 则 
返回 失败 信息 ; 若 验证 成 功 , 则 使 用 cleaned_data 方法 对 字段 weight 进行 清 洗 ， 
字段 weight 清洗 由 自 定义 函数 clean weight 完成 ， 最 后 将 表单 数据 保存 到 数 
据 库 , 保存 数据 有 三 种 方式 , 具体 说 明 可 看 代码 注释 , 运行 结束 如 图 7-3 所 示 。 





€ GC | © 127.0.0.1:8000/1.html 


产品 名 称 : 荣 疆 V10 

重量 : 172g 

尺寸 : 1157.00*74.98*6 97mm 
产品 类 型 : [Type object (1) 
产品 序号 : 
| 提交 | 











图 7-3 运行 结果 

















我 们 在 views.py 中 实现 了 表单 ProductModelForm 的 使 用 。 在 实现 过 程 中 ， 读 者 


可 能 会 产 
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生 以 下 疑问 : 

当 请 求 方式 为 GET 的 时 候 ， 设 置 表单 ProductModelForm 的 参数 instance 相当 
于 为 表单 进行 初始 化 ， 那 么 表单 的 初始 化 有 哪些 方法 ? 

图 7-3 的 下 拉 框 数据 是 一 个 模型 Type 对 象 ， 如 何 将 模型 Type 的 字段 type_ 
name 的 数据 在 下 拉 框 中 展示 呢 ? 

将 表单 数据 保存 到 数据 库 中 ， 三 种 保存 方式 有 什么 区 别 ? 


小 
出 
六 
并 
间 
四 

















针对 疑问 一 ， 表 单 的 初始 化 有 4 种 方法 ， 每 一 种 方法 都 有 自己 的 适用 范围 : 


























(1) 在 视图 函数 中 对 表单 类 进行 实例 化 时 ， 可 以 设置 实例 化 对 象 的 参数 initial。 

















例如 ProductModelForm (initial={'name':value})， 参 数值 以 字典 的 格式 表示 ， 字 典 的 
键 为 表单 的 字段 名 ， 这 种 方法 适用 于 所 有 表单 类 。 




















(2) 在 表单 类 中 进行 实例 化 时 ， 如 果 初 始 化 的 数据 是 一 个 模型 对 象 的 数据 ， 可 


以 设置 参数 instanse， 这 种 方法 只 适用 于 ModelForm， 如 ProductModelForm (instanse= 


instanse)。 


(3) 定义 表单 字段 时 ， 可 以 对 表单 字段 设置 初始 化 参数 initial， 此 方法 不 适用 于 


ModelForm, 如 name = forms.CharField(initial=value)。 








(4) 重 写 表 单 类 的 初始 化 函数 _ init OO， 适用 于 所 有 表单 类 ， 如 在 初始 化 函数 














_init () 中 设置 selffields['name'].initial = value。 





上 述 四 种 初始 化 方法 中 ， 我 们 以 方法 (3〉 和 方法 (4) 为 例 ， 在 定义 表单 类 时 设 


置 表单 的 初始 化 ， 代 码 如 下 : 


# 数据 库 表单 
class ProductModelForm(forms.ModelForm): 
# 方法 四 : 重 写 ProductModelForm 类 的 初始 函数 _ init __ 
def _init (self, *args, **kwargs): 
super (ProductModelForm, self). init  (*args, **kwargs) 
self .fields['name'] .initial = ' 我 的 手机 ，' 
# 方法 三 : 定义 表单 字段 时 ， 设 置 参数 initial 
productId = forms.CharField(max_length=20，1label=' 产品 序号 '， 


initial="'NO1') 


如 图 





重启 MyDjango 项 目 ， 在 浏览 器 上 访问 http://127.0.0.1:8000/111.html， 运 行 结果 
7-4 所 示 。 











: GC |© 127.0.0.1:8000/111.html 


产品 名 称 : 城 的 # 机 | 
一 
尺寸 : 

产品 类 型 :一 “| 

产品 序号 : NO1 














图 7-4 运行 结果 
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解决 疑问 一 的 表单 初始 化 问题 后 ， 我 们 接着 分 析 疑 问 二 可 以 发 现 ， 下 拉 框 的 数据 
是 一 个 模型 Type 对 象 ， 而 下 拉 框 是 由 模型 Product 的 外 键 type 所 生成 的 ， 外 键 type 
指向 模型 Type。 因 此 ， 要 解决 下 拉 框 的 数据 问题 ， 可 以 从 定义 模型 或 者 定义 表单 这 
两 方面 解决 。 

定义 模型 是 在 定义 模型 Type 时 , 设置 该 模型 的 返回 值 . 当 有 外 键 指向 模型 Type 时 ， 
模型 Type 会 将 返回 值 返回 给 外 键 。 在 模型 中 通过 重 写 “str “函数 可 以 设置 模型 的 返 
回 值 ， 代 码 如 下 : 


# models.py 
class Type (models.Model): 
id = models.AutoField (primary key=True) 
type_name = models.CharField (max length=20) 
# 设置 返回 值 ， 若 不 设置 ， 则 默认 返回 Type 对 象 
def _str (self): 
return self.type name 


如 果 存 在 多 个 下 拉 框 ， 而 且 每 个 下 拉 框 的 数据 分 别 取 同一 个 模型 的 不 同 字段 ， 那 
么 重 写 str “函数 可 能 不 太 可 行 。 遇 到 这 种 情况 ， 可 以 在 定义 表单 类 的 时 候 重 写 初 
始 化 函数 _ init QO， 代 码 如 下 : 

class ProductModelForm(forms.ModelForm): 


# 重 写 ProductModelForm 类 的 初始 函数 _ init __ 


def _init (self, *args, **kwargs): 


super (ProductModelForm, self). init  (*args, **kwargs) 
# 设置 下 拉 框 的 数据 

type_obj = Type.objects.values('type_ name') 

choices list = [(i + 1, v['type name']) for i, v in 


enumerate (type_obj)] 
self.fields['type'] .choices = choices list 


# 初始 化 字段 name 
self.fields['name'] .initial = ' 我 的 手机 ' 


最 后 对 于 疑问 三 所 提 及 的 数据 保存 ， 实 质 上 数据 保存 只 有 save() 和 save_m2m() 
方法 实现 ， 在 上 述 代 码 中 所 演示 的 三 种 保存 方式 ， 前 两 者 是 save( 的 参数 commit 的 
不 同 而 导致 保存 方式 有 所 不 同 。 如 果 参 数 commit 为 True， 直 接 将 表单 数据 保存 到 数 
据 库 ， 如 果 参 数 commit 为 False， 这 时 将 生成 一 个 数据 库 对 象 ， 然 后 可 以 对 该 对 象 进 
行 增删 改 查 等 数据 操作 ， 再 将 修改 后 的 数据 保存 到 数据 库 中 。 

值得 注意 的 是 saveO 只 适合 将 数据 保存 在 非 多 对 多 数据 关系 的 数据 表 ， 而 save_ 
m2m() 只 适合 将 数据 保存 在 多 对 多 数据 关系 的 数据 表 。 
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7.5 本 章 小 结 


用 户 表单 是 Web 开发 的 一 项 基本 功能 ，Django 的 表单 功能 由 Form 类 实现 ， 主 
要 分 为 两 种 :django.forms.Form 和 django.forms.ModelForm。 前 者 是 一 个 基础 的 表单 
功能 ， 后 者 是 在 前 者 的 基础 上 结合 模型 所 生成 的 数据 表单 。 


一 个 完整 的 表单 主要 有 4 个 组 成 部 分 提交 地 址 、 请 求 方式 、 元 素 控件 和 提交 按钮 。 
其 说 明 如 下 : 


e 提交 地 址 用 于 设置 用 户 提交 的 表单 数据 应 由 哪个 URL 接收 和 处 理 ， 由 控件 
<form> 的 属性 action 决定 。 当 用 户 向 服务 器 提交 数据 时 ， 若 属性 action 为 空 ， 
提交 的 数据 应 由 当前 的 URL 来 接收 和 处 理 ， 否 则 网 页 会 跳 转 到 属性 action 所 
指向 的 URL 地 址 。 

。 请求 方式 用 于 设置 表单 的 提交 方式 ， 通 常 是 GET 请 求 或 POST 请 求 ， 由 控件 
<form> 的 属性 method 决定 。 

@ 元 素 控 件 是 供用 户 输入 数据 信息 的 输入 框 。 由 HTML 的 <input> 控件 实现 ， 
其 控件 属性 type 用 于 设置 输入 框 的 类 型 ， 常 用 的 输入 框 类 型 有 文本 框 、 下 拉 
框 和 复 选 框 等 。 

e@ 提交 按钮 供用 户 提交 数据 到 服务 器 ， 该 按钮 也 是 由 HTML 的 <input> 控件 实 
现 的 。 但 该 按钮 具有 一 定 的 特殊 性 ， 因 此 不 归纳 到 元 素 控件 的 范围 内 。 


Django 的 表单 功能 主要 是 通过 定义 表单 类 ， 再 由 类 的 实例 化 生成 HIML 的 表单 
元 素 控件 ， 这 样 可 以 在 模板 中 减少 HTML 的 硬 编码 。 每 个 HTML 的 表单 元 素 控件 由 
表单 字段 来 决定 ， 代 码 如 下 : 


# 表单 类 ProductForm 的 表单 字段 name 

name = forms.CharField(max length=20，label="' 名 字 ',) 

# 表单 字段 name 所 生成 的 HTML 元 素 控件 

<tr> 

<th><label for="id name"> 名 字 :</label></th> 

<td><input type="text" name="name" id="id name" required maxlength="20" 
/></td> 

</tr> 


从 表单 字段 转换 HTML 元 素 控件 可 以 发 现 : 
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e@ 字段 name 的 参数 label 转换 成 HIML 的 标签 <label> 的 值 。 

@ 字段 name 的 forms.CharField 类 型 转换 成 HIML 的 <input type="text"> 控件 ， 
标签 <input> 是 一 个 输入 框 控件 ，type="text" 代表 当前 输入 框 为 文本 输入 框 ， 
参数 type 用 于 设置 输入 框 的 类 型 。 

e 表单 字段 name 的 命名 转换 成 <input> 控件 的 参数 name 的 值 ， 表 单字 段 name 
的 参数 max length 转换 成 <input> 控件 的 参数 required maxlength 的 值 。 


数据 表单 是 将 模型 的 字段 转换 成 表单 的 字段 ， 再 从 表单 的 字段 生成 HTML 的 元 
素 控件 ， 这 是 日 常 开发 中 常用 的 表单 之 一 。 数 据 表单 以 类 的 形式 定义 ， 其 内 部 可 分 为 
三 大 部 分 : 添加 模型 外 的 表单 字段 、 模 型 与 表单 设置 和 自 定义 函数 ， 说 明 如 下 : 


e@ ”添加 模型 外 的 表单 字段 是 在 模型 已 有 的 字段 下 添加 额外 的 表单 字段 。 

@ ”模型 与 表单 设置 是 将 模型 的 字段 转换 成 表单 字段 ， 由 类 Meta 的 属性 实现 两 者 
的 字段 转换 。 

ee 自 定义 函数 是 重 写 模块 ModelForm 中 的 函数 ， 使 其 符合 开发 需求 ， 如 重 写 初 
始 化 函数 init 和 自 定义 数据 清洗 函数 等 。 
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Admin 后 台 系 统 也 称 为 网 站 后 台 管理 系统 , 主要 用 于 对 网 站 前 台 的 信息 进行 管理 ， 
如 文字 、 图 片 、 影 音 和 其 他 日 常 使 用 文件 的 发 布 、 更 新 、 删 除 等 操作 ， 也 包括 功能 信 
息 的 统计 和 管理 ， 如 用 户 信息 、 订 单 信息 和 访客 信息 等 。 简 单 来 说 ， 就 是 对 网 站 数据 
库 和 文件 的 快速 操作 和 管理 系统 ， 以 使 网 页 内 容 能 够 及 时 得 到 更 新 和 调整 。 


8.1 走 进 Admin 





当 一 个 网 站 上 线 之 后 , 网 站 管理 员 是 通过 网 站 后 台 系统 对 网 站 进行 管理 和 维护 的 。 
Django 已 内 置 了 强大 的 Admin 后 台 系统 ， 在 创建 Django 项 目的 时 候 ， 可 以 从 配置 文 
件 settings.py 中 看 到 项 目 己 默认 启用 Admin 后 台 系 统 ， 如 图 8-1 所 示 。 

从 图 8-1 中 看 到 , 在 INSTALLED _APPS 中 已 配置 了 Django 的 Admin 后 台 系 统 ， 
如 果 网 站 不 需要 Admin 后 台 系 统 ， 可 以 将 配置 信息 删除 ， 这 样 可 以 减少 程序 对 系统 资 
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源 的 占用 。 此 外 ， 在 根 目 录 的 urlspy 中 也 可 以 看 到 Admin 的 URL 地 址 信息 ， 我 们 在 
浏览 器 上 输入 http://127.0.0.1:8000/admin 就 能 访问 Admin 后 台 系统 ， 如 图 8-2 所 示 。 





D Log in | Django site a x o> 
€ GC |© 127.0.0.1:8000/admin/login/?... 上 从 | : 





INSTALLED_APPS = [ 


"django. contrib. admin’ , 


"django. contrib. auth’, 


"django. contrib. sessions’ , 
"django. contrib, nessages’, 
"django. contrib, staticfiles’, 
"index’, 





] 


"django. contrib. contenttypes’ , 














Password: 


LOGIN 











图 8-1 Admin 配置 信息 


图 8-2 Admin 登录 页 面 

















在 访问 Admin 后 台 系 统 时 ， 首 先 需 要 输入 用 户 的 账号 和 密码 登录 才能 进入 后 台 
管理 界面 。 创 建 用 户 的 账号 和 密码 之 前 ， 必 须 确保 项 目的 模型 在 数据 库 中 有 相应 的 数 
据 表 ， 以 MyDjango 为 例 ， 项 目的 数据 表 如 图 8-3 所 示 。 

如 果 Admin 后 台 系 统 以 英文 的 形式 显示 ， 那 么 我 们 还 需要 在 项 目的 settings.py 
































中 设置 MIDDLEWARE 中 间 件 ， 将 后 台 内 容 以 中 文 形 式 显示 。 添 加 的 中 间 件 是 有 先 


后 顺序 的 ， 有 具体 可 回顾 2.5 节 ， 设 置 如 图 8-4 所 示 。 

















围 auth_group 

围 auth_group_permissions 
国 auth_permission 
auth_user 

围 auth_user_ groups 
auth_user_user_permissions 
围 diango admin log 

围 django_content type 

围 django_migrations 

围 django_session 

转 index_product 

围 index type 

































































































































































MIDDLEWARE = [ 

" django. middleware. security. SecurityMiddleware’, 
"django. contrib. sessions. middleware. Sessionliddleware' ， 
ER 








ddleware. locale. leMiddleware’ , 
ddleware. comnon. ComnonMiddleware’ , 
‘ddleware. csrf.CsrfViewkiddleware’, 
" django. contrib. auth. middleware. Authenticationliddleware’, 





"django. contrib. nessages. niddleware. MessageMiddleware’, 
"django. niddleware. clickjacking.Xpraae0ptionsMiddleware'， 














图 8-3 数据 表 信 息 








图 8-4 设置 中 文 显示 





完成 上 述 设 置 后 ， 下 一 步 是 创建 用 户 的 账号 和 密码 ， 创 建 方法 由 Django 的 管理 
工具 manage.py 完成 ， 在 PyCharm 的 Terminal 模式 下 输入 创建 指令 ， 代 码 如 下 : 
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算 机 的 用 户 名 ， 而 设置 用 户 密码 时 ， 输 入 的 密码 不 会 显示 在 计算 机 的 屏幕 上 。 完 成 用 
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E:\MyDjango>python manage.py createsuperuser 


Username (leave blank to use 'cxuser02'): root 
Email address: 554301449@qq.com 
Password: 


Password (again): 
Superuser created successfully. 


在 创建 用 户 信息 时 ， 用 户 名 和 邮箱 地 址 可 以 为 空 ， 如 果 用 户 名 为 空 会 默认 使 用 计 













































































户 创建 后 ， 打 开 数 据 表 auth_user 可 看 到 新 增 了 一 条 用 户 信息 ， 如 图 8-5 所 示 。 














国 auth_user @mydjango (My-… 
三 站 FS 和 国名 证 -本 FE 与 # 四 SA 四 3Sd 
id password lastlogin is superuser usemame 。 firstname lastname email is staff is active datejoined 
， 国 加 pokdf2 :ha2 1 root 554301449@qq.com 1 1 2018-03-12 02:45:40.8529 
图 8-5 用 户 信 息 


在 Admin 登录 页 面 上 使 用 刚 创 建 的 账号 和 密码 登录 ， 即 可 进入 Admin 后 台 系统 





的 页 面 ， 如 图 8-6 所 示 。 





8-6 Admin 后 台 系 统 页 面 


在 Admin 后 台 系 统 中 可 以 看 到 , 主要 功能 分 为 站 点 管理 、 认 证 和 授权 、 用 户 和 组 ， 


说 明 如 下 : 


ee ”站 点 管理 是 整个 网 站 的 App 管 理 界 面 ,主要 管理 Django 的 App 下 所 定义 的 模型 。 
e@ ”认证 和 授权 是 Django 内 置 的 认证 系统 ， 也 是 项 目的 一 个 App。 
e 用 户 和 组 是 认证 和 授权 所 定义 的 模型 ， 分别 对 应 数据 表 auth user 和 auth_ 


User groups。 


在 MyDjango 中 ， 已 在 index 中 定义 了 模型 Product 和 Type， 分 别 对 应 数据 表 
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index_product 和 index_type。 若 想 将 index 定义 的 模型 展示 在 Admin 后 台 系 统 中 ， 则 
需要 在 index 的 admin py 中 添加 以 下 代码 : 


from django.contrib import admin 
from .models import * 


# 方法 一 
# 将 模型 直接 注册 到 admin 后 台 


admin.site.register (Product) 


# 方法 二 : 
# 自 定义 Productadmin 类 并 继承 ModelAdmin 
# 注册 方法 一 ， 使 用 Python 装饰 器 将 Productadmin 和 模型 Product 绑 定 并 注册 到 后 台 
Q@admin.register (Product) 
class ProductAdmin (admin.ModelAdmin): 
# 设置 显示 的 字段 
list display = ['id', 'name', 'weight', 'size', 'type',] 
# 注册 方法 二 


# admin.site.register(Product, ProductAdmin) 


上 述 代码 以 两 种 方法 将 数据 表 index_product 注册 到 Admin 后 台 系 统 ， 方 法 一 是 
基本 的 注册 方式 ; 方法 二 是 通过 类 的 继承 方式 实现 注册 。 日 常 的 开发 都 是 采用 第 二 种 
方法 实现 的 ， 实 现 过 程 如 下 : 





e 自 定义 ProductAdmin 类 ， 使 其 继承 ModelAdmin。ModelAdmin 主要 设置 模型 
信息 如 何 展现 在 Admin 后 台 系 统 中 。 

e 将 ProductAdmin 类 注册 到 Admin 后 台 系统 中 有 两 种 方法 ， 两 者 都 是 将 模型 
Product 和 ProductAdmin 类 绑 定 并 注册 到 Admin 后 台 系 统 。 


以 ProductAdmin 类 为 例 ， 刷 新 Admin 后 台 系 统 页 面 ， 看 到 站 点 管理 出 现 
INDEX， 代 表 项 目的 index，INDEX 下 的 Products 是 index 中 的 模型 Product， 对 应 数 
据 表 index_product， 如 图 8-7 所 示 。 








图 8-7 模型 Product 的 后 台 管 理 
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8.2 Admin 的 基本 设置 


在 8.1 节 中 ， 我 们 将 数据 表 index product 成 功 展现 在 站 点 管理 的 页 面 ， 但 对 一 
个 不 会 网 站 开发 的 使 用 者 来 说 ， 可 能 无 法 理解 INDEX 和 Products 的 含义 ， 而 且 用 英 
文 表示 也 会 影响 整个 网 页 的 美观 。 因 此 ， 我 们 需要 将 INDEX 和 Products 转换 成 具体 
的 中 文 内 容 。 将 INDEX 和 Products 设置 中 文 显示 需要 分 别 使 用 不 同 的 方法 实现 ， 因 
为 INDEX 和 Products 在 项 目 中 分 别 代表 不 同 的 意思 ， 前 者 是 一 个 App 的 命名 ， 后 者 
是 一 个 App 中 定义 的 模型 。 


首先 实现 INDEX 的 中 文 显 示 , 主要 由 App 的 _init .py 文件 实现 , 实现 代码 如 下 : 





# INDEX 设置 中 文 ， 代 码 编写 在 App (index) 的 _ init_ _ .py 文件 中 
from django .apps import AppConfig 

import os 

# 修改 App 在 Admin 后 台 显 示 的 名 称 

# default_app_config 的 值 来 自 apps .py 的 类 名 

default app_config = 'index.IndexConfig' 


# 获取 当前 App 的 命名 
def get current app name( file): 
return os.path.split (os.path.dirname( file)) [-1] 


# 重 写 类 IndexConfig 

class IndexConfig (AppConfig): 
name = get_current_app_name(_ file ) 
verbose_name = ' 网 站 首页 ' 


当 项 目 启动 时 ， 程 序 会 从 初始 化 文件 _init ”获取 重 写 的 mdexConfig 类 ， 类 属 
性 verbose_name 用 于 设置 INDEX 的 中 文 内 容 。 

然后 将 Products 设置 中 文 显示 ， 在 models py 中 设置 类 Meta 的 类 属性 verbose_ 
name _plural 即 可 实现 。 值 得 注意 的 是 ，Meta 的 类 属性 还 有 verbose_name， 两 者 都 能 
设置 Products 的 中 文 内 容 ， 但 verbose_name 是 以 复数 形式 表示 的 ， 如 将 Products 设 
置 为 “产品 信息 ”，verbose_name 会 显示 为 “产品 信息 s”， 实 现代 码 如 下 : 

# Products 设置 中 文 ， 代 码 编写 在 models .py 文件 中 

# 创建 产品 信息 表 

# 设置 字段 中 文 名 ， 用 于 Admin 后 台 显示 


class Product (models.Model): 


| 
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id = models.AutoField(' 序 号 ',， primary key=True) 
name = models.CharField(' 名 称 ',max length=50) 
weight = models .CharField(' 重量 ' max length=20) 
size = models.CharField(' 尺寸 "rmax length=20) 
type = models.ForeignKey (Type, on delete=models .CASCADE,verbose 
name="' 产品 类 型 ') 
# 设置 返回 值 
def _ str _ (self}): 
return self.name 
class Meta: 
# 如 只 设置 verbose_name， 在 Rdmin 会 显示 为 " 产品 信息 s" 
verbose_name =' 产品 信息 ' 
verbose_name_plural = ' 产品 信息 ' 


除 此 之 外 ， 我 们 还 可 以 进一步 完善 Admin 网 页 标题 信息 ， 在 App 的 admin.py 文 
件 中 编写 以 下 代码 : 


# index 的 admin.py 文 件 

# 修改 title 和 header 

from django.contrib import admin 
from .models import * 


# 修改 title 和 header 
admin.site.site title = 'MyDjango 后 台 管 理 ' 
admin.site.site header = 'MyDjango' 


# 自 定义 Productadmin 类 并 继承 ModelAdmin 
@admin.register (Product) 
class ProductAdmin (admin.ModelAdmin): 
# 设置 显示 的 字段 
list display = ['id', 'name', 'weight', "size'， 'type',] 
上 述 例子 实现 了 INDEX、Products 的 中 文 设置 和 Admin 网 页 标题 内 容 的 修改 ， 
分 别 由 index 的 初始 化 文件 _init 、 模 型 文件 modelspy 和 adminpy 实现 。 运 行 


MyDjango 项 目 ，Admin 管理 页 面 如 图 8-8 所 示 。 








图 8-8 Admin 管理 页 面 
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当 单 击 图 8-8 中 的 “产品 信息 ”时 ， 网 页 会 进入 模型 Product 的 数据 页 面 ， 数 据 
以 表格 的 形式 展示 。 从 表格 上 可 以 发 现 ， 表 头 信息 代表 模型 的 字段 ， 并 且 表 头 是 以 中 
文 的 形式 展现 的 。 如 果 细 心 观察 就 会 发 现 ， 在 上 述 例子 中 ，models.py 所 定义 的 模型 
Product 的 字段 设置 了 中 文 内 容 ， 中 文 内 容 是 字段 参数 verbose_name 的 参数 值 ， 所 以 
模型 Product 的 数据 表 头 才 以 中 文 的 形式 展现 ， 如 图 8-9 所 示 。 











8-9 模型 Product 的 数据 信息 


从 图 8-9 中 可 以 发 现 ， 产 品类 型 的 数据 是 一 个 模型 Type 对 象 ， 与 第 7 章 的 表单 
下 拉 框 数据 设置 是 同一 个 问题 。 因 此 ， 在 模型 Type 中 定义 str 函数， 设置 模型 的 
返回 值 ， 代 码 如 下 : 


# 创建 产品 分 类 表 

# 设置 字段 中 文 名 ， 用 于 Admin 后 台 显示 

class Type (models.Model): 
id = models.AutoField(' 序 号 ',， primary_key=True) 
type_name = models.CharField(' 产品 类 型 '，max_length=20) 
# 设置 返回 值 
def _ str (self): 


return self.type name 
在 浏览 器 上 刷新 当前 网 页 ， 可 以 发 现 产 品类 型 的 数据 变 为 模型 字段 Type_name 的 
数据 ， 如 图 8-10 所 示 。 




















D ssrsaxs se x 
€ 3 © [© 12700.+9000/edmin/inde/produe 





图 8-10 模型 Product 的 数据 信息 


113 


玩 转 Django 2.0 


当 一 个 数据 表 中 存储 了 成 千 上 万 的 数据 ， 在 Admin 中 查找 该 表 的 某 条 数据 信息 
时 ， 如 果 不 使 用 一 些 查找 功能 ， 是 无 法 精准 地 找到 需要 的 数据 信息 的 。 为 解决 这 个 问 
题 ， 可 以 在 admin.py 中 进一步 优化 ProductAdmin， 优 化 代码 如 下 : 





























# admin.py 
from django.contrib import admin 
from .models import * 
Qadmin.register (Product) 
class ProductAdmin (admin.ModelAdmin): 
# 设置 模型 字段 ， 用 于 Admin 后 台数 据 的 表 头 设置 
list display = ['id', 'name', 'weight', '‘'size', 'type',] 
# 设置 可 搜索 的 字段 并 在 Admin 后 台数 据 生成 搜索 框 ， 如 有 外 键 ， 应 使 用 双 下 画 线 连接 两 个 
模型 的 字段 
search fields = ['id', 'name','type type name'] 
# 设置 过 滤器 ， 在 后 台数 据 的 右 侧 生成 导航 栏 ， 如 有 外 键 ， 应 使 用 双 下 画 线 连接 两 个 模型 的 字段 
list filter = ['name' "type_ type name'] 
# 设置 排序 方式 ，['id'] 为 升序 ， 降 序 为 ['-id'] 
ordering = ['id'] 
# 设置 时 间 选 择 器 ， 如 字段 中 有 时 间 格 式 才 可 以 使 用 
# date hierarchy = Field 
# 在 添加 新 数据 时 ， 设 置 可 添加 数据 的 字段 





fields = ['name', '‘'weight', 'size', 'type'] 
# 设置 可 读 字 段 ， 在 修改 或 新 增 数据 时 使 其 无 法 设置 
readonly fields = ['name'] 


上 述 代 码 中 ，ProductAdmin 类 分 别 设置 list_display、search fields、list_filter、 
ordering、date_hierarchy、fields 和 readonly_fields 属性 ， 每 个 属性 的 作用 在 代码 注 
释 已 有 说 明 。 除 了 date_ hierarchy 之 外 ， 其 他 属性 值 还 可 以 使 用 元 组 格式 表示 。 在 
ProductAdmin 类 新 增 的 属性 都 能 在 页 面 中 生成 相应 的 功能 ， 如 图 8-11 所 示 。 
























































图 8-11 模型 Product 的 数据 信息 


值得 注意 的 是 ， 如 果 readonly fields 和 fields 属性 设置 了 模型 的 同一 个 字段 ， 
那么 在 新 增 数据 的 时 候 ， 该 模型 字段 是 无 法 输入 数据 的 。 例 如 上 述 设置 ，readonly_ 
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fields 和 fields 同时 设置 了 name 字段 ， 在 新 增 数据 时 ， 该 字段 的 值 默认 为 空 并 且 无 法 
输入 数据 ， 如 图 8-12 所 示 。 




















图 8-12 新 增 数据 








8.3 Admin 的 二 次 开发 


前 面 的 章节 讲述 了 Admin 的 基本 设置 ， 但 实际 上 每 个 网 站 的 功能 和 需求 都 是 各 
不 相同 的 ， 这 也 导致 了 Admin 后 台 功 能 有 所 差异 。 因 此 ， 通 过 重 写 ModelAdmin 的 方 
法 可 以 实现 Admin 的 二 次 开发 ， 满 足 多 方面 的 开发 需求 。 








8.3.1 函数 get_readonly_fields 


函数 get_readonly_fields 和 属性 readonly_fields 的 功能 相似 ， 不 过 前 者 比 后 者 更 为 
强大 。 比 如 使 用 函数 get_readonly_fields 实现 不 同 的 用 户 角 色 来 决定 字段 的 可 读 属性 ， 
实现 代码 如 下 : 



































# 重 写 get_readonly_fields 函数 ， 设 置 超级 用 户 和 普通 用 户 的 权限 
def get readonly fields (self, request, obj=None): 
if request.user.is_ superuser: 
self.readonly fields = [] 
return self.readonly fields 


函数 get_readonly_fields 首先 判断 当前 发 送 请 求 的 用 户 是 否 为 超级 用 户 ， 如 果 符 合 
判断 条 件 ， 将 重新 设置 readonly_fields 属性 ， 使 当前 用 户 具 有 全 部 字段 的 编辑 权限 。 其 
中 ， 函 数 参数 request 是 当前 用 户 的 请 求 对 象 ， 参 数 obj 是 模型 对 象 ， 默 认 值 为 None。 

在 浏览 器 上 通过 切换 不 同 的 用 户 登 录 ， 可 以 发 现在 新 增 或 者 修改 数据 的 时 候 ， 不 
同 的 用 户 身份 对 字段 name 的 操作 权限 有 所 不 同 ， 如 图 8-13 所 示 。 
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8-13 切换 不 同 的 用 户 登录 





8.3.2 设置 字段 格式 


在 Admin 预览 模型 Product 的 数据 信息 时 ， 数 据 表 的 表 头 是 由 属性 list_display 
所 定义 的 ， 每 个 表 头 的 数据 都 来 自 于 数据 库 ， 并 且 数 据 以 固定 的 字体 格式 显示 在 网 页 
上 。 若 要 对 某 些 字段 的 数据 进行 特殊 处 理 ， 如 设置 数据 的 字体 颜色 ， 以 模型 Product 
的 type 字段 为 例 ， 将 该 字段 的 数据 设置 为 不 同 的 颜色 ， 实 现代 码 如 下 : 





# models .py 的 模型 Product 

from django.utils.html import format html 

class Product (models.Model): 
id = models.AutoField(' 序 号 '， primary_key=True) 
name = models.CharField(' 名 称 ',max_length=50) 
weight = models.CharField(' 重量 ' max_ length=20) 
size = models.CharField(' 尺寸 ',max_ length=20) 
type = models.ForeignKey (Type, on _delete=models.CASCADE,verbose_ 

name=' 产品 类 型 ') 
# 设置 返回 值 
def _str {self): 
return self.name 














class Meta: 
# 设置 verbose_name， 在 Rdmin 会 显示 为 " 产品 信息 s" 
verbose_name = ' 产品 信息 ' 
Verbose_name_plural = ' 产品 信息 ' 


# 自 定义 函数 ， 设 置 字体 颜色 
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def colored type (self) : 
if ' 手 机 ' in self.type.type name: 


color code = "Fed' 

elif ' 平板 电脑 ' in self.type.type name: 
color code = "blue' 

elif ' 智能 穿戴 ' in self.type.type name: 
color code = 'green' 

else: 
color code = 'yellow' 


return format html( 
'<span style="color: {};">{}</span>', 
color code, 
self.type, 


) 
# 设置 Admin 的 标题 
colored type.short_description =' 带 颜 色 的 产品 类 型 ' 


# 在 admin.py 的 ProductAdmin 中 添加 自 定义 字段 


# 添加 自 定义 字段 ， 在 属性 1ist_display 中 添加 自 定义 字段 colored_type,， colored type 
来 自 于 模型 Porduct 


list display.append('colored type') 
从 上 述 代码 可 以 看 到 ， 设 置 字段 的 数据 格式 主要 由 文件 models.py 和 admin.py 实 
现 ， 说 明 如 下 : 


e。 在 models.py 的 模型 Product 中 定义 函数 colored_ _ type， 函数 名 可 以 自行 命名 ， 
该 函数 通过 判断 模型 字段 的 数据 内 容 ， 从 而 返回 不 同 的 字体 颜色 。 

e 然后 在 admin.py 的 类 ProductAdmin 的 属性 list_display 中 添加 模型 Product 的 
函数 colored type， 使 该 函数 以 表 头 的 形式 显示 在 Admin 后 台 的 数据 信息 页 面 
上 。 运 行 结果 如 图 8-14 所 示 。 
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图 8-14 新 增 自 定义 字段 
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8.3.3 函数 get_queryset 

函数 get_queryset 根据 不 同 用 
要 的 数据 进行 过 滤 。 以 模型 Product 为 例 ， 在 admin.py 的 类 ProductAdmin 中 
数 get queryset， 代 码 如 下 : 




































# admin.py 的 类 ProductRdmin 
# 根据 当前 用 户 名 设置 数据 访问 权限 
def get queryset (self, request): 
qs = super(ProductAdmin, self) .get queryset (request) 
if request.user.is_ superuser: 
return qs 
else: 
return qs.filter(id 1t=6 


分 析 上 述 代码 可 知 ， 自 定义 函数 get_queryset 的 代码 说 明 如 下 : 
ee 首先 通过 super 方法 来 获取 父 类 ModelAdmin 的 函数 get_queryset 所 生成 的 查 
询 对 象 ， 该 对 象 用 于 查询 模型 Product 的 全 部 数据 。 


e@ 然后 判断 当前 用 户 的 用 户 身 份 ， 如 果 为 超级 用 户 ， 函 数 返回 模型 Product 的 全 
部 数据 ， 否 则 只 返回 模型 Product 的 前 5 条 数据 。 运 行 结果 如 图 8-15 所 示 。 











图 8-15 设置 数据 访问 权限 


8.3.4 函数 formfield_for_foreignkey 


函数 formfield for foreignkey 用 于 在 新 增 或 修改 数据 的 时 候 ， 设 置 外 键 的 可 选 值 。 
如 果 在 模型 中 将 某 字 段 定义 为 外 键 类 型 ， 当 新 增 数据 时 ， 该 字段 为 一 个 下 拉 框 控件 ， 
下 拉 框 中 的 数据 来 自 于 该 字段 所 指向 的 模型 ， 如 图 8-16 所 示 。 

















118 


第 8 章 Admin 后 台 系统 




















sm 
sn 
Re 
re 寺 

[| 

Ea 

Fe 

ed 

se 

图 8-16 新 增 数据 











如 果 想 要 对 下 拉 框 中 的 数据 实现 过 滤 功 能 ， 可 以 对 函数 formfield for foreignkey 
进行 重 写 ， 代 码 如 下 : 





# 新 增 或 修改 数据 时 ， 设 置 外 键 可 选 值 
def formfield for foreignkey(self, db field, request, **kwargs): 
if db field.name == 'type': 
if not request.user.is superuser: 
kwargs["queryset"] = Type.objects.filter(id 1t=4) 
return super(admin.ModelAdmin, self).formfield for foreignkey (db field, 
request, **kwargs) 
上 述 代 码 通过 重 写 函数 formfield for foreignkey， 实 现下 拉 框 的 数据 过 滤 ， 实 现 
说 明 如 下 : 
ee 参数 db field 是 模型 Product 的 外 键 对 象 ， 一 个 模型 可 以 定义 多 个 外 键 ， 因 此 
函数 首先 对 外 键 名 进行 判断 。 
e ”然后 判断 当前 用 户 是 否 为 超级 用 户 ， 参 数 request 是 当前 用 户 的 请 求 对 象 。 
@ ”如 果 当 前 用 户 为 普通 用 户 ， 则 设置 参数 kwargs 的 queryset， 参 数 kwargs 是 以 
字典 的 形式 作为 函数 参数 ，queryset 是 参数 kwargs 的 键 。 
e。 最 后 将 设置 好 的 参数 kwargs 传递 给 父 类 的 函数 formfield_for foreignkey 重新 
执行 。 运 行 结果 如 图 9-17 所 示 。 











EE: 
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图 8-17 设置 外 键 可 选 值 
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8.3.5 函数 save_model 


函数 save_ model 是 在 新 增 或 修改 数据 的 时 候 ， 点 击 保存 按钮 所 触发 的 功能 ， 该 
函数 主要 对 输入 的 数据 进行 入 库 和 更 新 处 理 。 若 想 在 这 功能 中 加 入 一 些 特 殊 的 功能 需 
求 ， 可 以 对 函数 save_model 进行 重 写 。 比 如 对 数据 的 修改 实现 一 个 日 志 记 录 ， 那 么 
函数 save_model 的 实现 代码 如 下 : 


# 修改 保存 方法 
def save model(self, request, obj, form, change): 
if change: 
# 获取 当前 用 户 名 
user = request.user 
# 使 用 模型 获取 数据 ，pk 代表 具有 主键 属性 的 字段 
name = self.model.objects.get (pk=obj.pk) .name 
# 使 用 表单 获取 数据 
weight = form.cleaned data['weight'] 
# 写 入 日 志文 件 
f = open('e://MyDjango log.txt', 'a') 
f.write(' 产品 : '+str (name)+'， 被 用 户 : '+str (user)+' 修改 '+'\r\n') 
f.close() 
elses 
pass 
# 使 用 super 可 使 自 定义 save_model 既 保留 父 类 已 有 的 功能 又 添加 自 定义 功能 


super (ProductAdmin, self) .save_model (request, obj, form, change) 
上 述 代码 中 ， 函 数 save_model 的 功能 说 明 如 下 : 
@ ”首先 判断 参数 change 是 否 为 True， 若 为 True， 则 说 明 当 前 操作 为 数据 修改 ， 
反之 为 新 增 数据 。 
。 分 别 从 三 个 函数 参数 中 获取 相关 的 数据 内 容 。 参 数 request 代表 当前 用 户 的 请 


求 对 象 ， 参 数 obj 代表 当前 数据 所 对 应 的 模型 对 象 ， 参数 form 代表 Admin 的 
数据 修改 页 面 所 对 应 的 数据 表单 。 

e。 然后 将 所 获取 的 数据 写 入 文本 文件 ， 实 现 简 单 的 日 志 记 录 功 能 。 

。 最 后 使 用 super 方法 使 重 写 函数 save_model 执行 原 有 函数 save_model 的 功能 ， 
对 数据 进行 入 库 和 变更 处 理 。 若 将 此 代码 注释 ， 当 触发 重 写 函 数 时 ， 程 序 只 
执行 日 志 记 录 功 能 ， 并 不 执行 数据 入 库 和 变更 处 理 。 


除 此 之 外 ， 还 有 数据 删除 所 执行 的 函数 delete_ model， 代 码 如 下 : 
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def delete model(self, request, obj): 
pass 
super (ProductAdmin, self) .delete model (request, obj) 


8.3.6 自 定义 模板 


Admin 后 台 系 统 的 HTML 模板 是 由 Diango 提供 的 ， 我 们 可 以 在 Django 的 安装 
目录 下 找到 Admin 模板 所 在 的 路 径 (\Lib\site-packages\django\contrib\admin\templates\ 
admin) 。 如 果 想 要 对 Admin 的 模板 进行 自 定义 更 改 ， 可 直接 修改 Django 里 面 的 
Admin 模板 ， 但 一 般 不 提倡 这 种 方法 。 如 果 一 台 计 算 机 同时 开发 多 个 Django 项 
这 样 会 影响 其 他 项 目的 使 用 。 除 了 这 种 方法 之 外 ， 还 可 以 利用 模板 继承 的 方法 实 
定义 模板 开发 。 我 们 对 MyDjango 项 目的 目录 架构 进行 调整 ， 如 图 8-18 所 示 。 
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> Bn MyDjango 
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图 8-18 项 目 目录 架构 





在 项 目 中 创建 模板 文件 夹 templates， 在 templates 下 依次 创建 文件 夹 admin 和 
index， 说 明 如 下 : 


e 文件 夹 admin 代表 该 文件 里 的 模板 用 于 Admin 后 台 管 理 系 统 ， 而 且 文件 夹 必 
须 命名 为 admin。 

e 文件 天 index 代表 项 目的 App， 文件 夹 的 命名 必须 与 App 的 命名 一 致 。 该 文件 
夹 存 放 模 板 文件 change form.html, 并 且 模 板 文件 只 适用 于 index 的 后 台数 据 。 

e。 如果 将 模板 change form.html 放 在 admin 文件 夹 下 ， 说 明 该 文件 适用 于 当前 项 
目的 所 有 App。 


值得 注意 的 是 ， 在 项 目 中 创建 文件 夹 templates 时 ， 切 勿 忘记 在 项 目 settings.py 中 
配置 templates 的 路 径 信 息 。 最 后 在 模板 change_form.html 中 编写 以 下 代码 : 
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{$$ extends "admin/change form.html" 名 } 

{$$ load il8n admin urls static admin modify %} 

$$ block object-tools-items $%} 

判断 当前 用 户 角色 #} 

{% if request.user.is superuser %} 

<1li> 

% Url optsladmin urlname:'"'history' original.pkladmin urlquote as 


在 


history url %} 

<a href="{%add preserved filters history url%}" 
class="historylink">{%trans "History"%}</a> 

ils 

# 判断 结束 符 #} 

% endif %} 

% if has absolute url %} 

<li><a href="{{ absolute url }}" class="viewsitelink">{% trans "View on 
site" %}</a></1i> 

% endif %} 

多 endblock %} 


从 代码 可 以 看 到 ， 自 定义 模板 change_form.html 的 代码 说 明 如 下 : 





@ 自 定 义 模 板 change form.html 首先 继承 自 Admin 源 模板 change_form.html， 
自 定 义 模 板 的 命名 必须 与 源 模板 的 命名 一 致 。 

例如 源 模版 admin/change form.html 导入 了 标签 {% load il8n admin_urls static 
admin modify %}， 因 此 自 定 义 模版 change_ form.html 也 需要 导入 该 模版 标签 。 

。 通过 使 用 block 标签 实现 源 模板 的 代码 重 写 。 我 们 查看 源 模板 的 代码 发 现 ， 
模板 代码 以 {% block xxx %} 形式 分 块 处 理 ， 将 网 页 上 不 同 的 功能 都 一 一 区 分 
了 。 因 此 ， 在 自 定义 模板 中 使 用 block 标签 可 对 某 个 功能 进行 自 定义 开发 。 


项 目 运行 时 ， 程 序 优先 查找 项 目 文 件 夹 admin 的 模板 文件 ， 若 找 不 到 相应 的 模 
板 文件 ， 再 从 Django 中 的 admin 源 模板 查找 。 在 上 述 例子 中 ， 使 用 超级 用 户 和 普通 
用 户 分 别 进入 产品 信息 的 数据 修改 页 面 时, 不 同 的 用 户 角色 所 返回 的 页 面 会 有 所 差异 ， 
如 图 8-19 所 示 。 

除了 上 述 例子 之 外 ，Dijango 的 Admin 后 台 管理 系统 还 提供 了 许多 功能 函数 ， 具 
体 函 数 的 说 明 以 及 使 用 此 处 不 做 一 一 讲解 ， 有 兴趣 的 读者 可 查阅 Django 官方 文档 说 
明 。 
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中 修改 产品 信息 | MyDjar x > 
€ > GC |© 12700.1:8000/jadmin/indeWproduct1/change/ 会 | 让 © |© 127.00.1:8000/admin/index/producy/1/change/ 会 | : 
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8-19 自 定义 模板 





8.4 本 章 小 结 


Admin 后 台 管 理 系统 也 称 为 网 站 后 台 管 理 系统 ， 主 要 用 于 对 网 站 前 台 的 信息 进行 
管理 ， 如 文字 、 图 片 、 影 音 和 其 他 日 常 使 用 文件 的 发 布 、 更 新 、 删 除 等 操作 ， 也 包括 
功能 信息 的 统计 和 管理 ， 如 用 户 信息 、 订 单 信息 和 访客 信息 等 。 简 单 来 说 ， 就 是 对 网 
站 数据 库 和 文件 的 快速 操作 和 管理 系统 ， 以 使 网 页 内 容 能 够 及 时 得 到 更 新 和 调整 。 

Admin 的 基本 设置 有 App 的 中 文 设置 、 模 型 的 中 文 设置 、Admin 网 页 标题 和 模 
型 数据 设置 ， 说 明 如 下 。 




















e App 的 中 文 设置 在 App 的 初始 化 文件 init ”中 重 写 IndexConfig 类 ， 设 置 
类 属性 verbose_name 即 可 实现 。 

ee 模型 的 中 文 设置 在 App 的 模型 文件 models.py 中 设置 类 Meta 的 类 属性 
verbose_name plural 即 可 实现 。 

e Admin 网 页 标题 : 在 App 的 admin.py 中 分 别 设置 属性 admin.site.site_title 和 
admin site site_header 即 可 实现 。 

e 模型 数据 设置 在 App 的 adminpy 中 自 定 义 类 并 且 继 承 父 类 admin. 
ModelAdmin， 通 过 重 写 父 类 的 属性 和 方法 可 实现 自 定义 模型 数据 设置 。 


Admin 的 二 次 开发 主要 对 父 类 admin ModelAdmin 中 已 有 的 方法 进行 重 写 ， 实 现 
定义 开发 。 常 用 的 方法 如 下 。 
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函数 get_ readonly fields 通过 重 写 该 函数 ， 可 以 根据 用 户 身 份 来 控制 数据 的 写 
入 权限 。 

设置 字段 格式 : 首先 在 模型 文件 modelspy 中 自 定义 函数 并 将 处 理 后 的 模型 字 
段 作为 函数 返回 值 ,然后 将 自 定义 的 函数 写 入 admin.py 的 类 属性 list display 中 。 
函数 get_queryset 根据 不 同 用 户 角 色 设置 数据 的 访问 权限 ， 该 函数 可 以 将 一 些 
重要 的 数据 进行 过 滤 。 

芳 数 formfield_for foreignkey 在 新 增 或 修改 数据 的 时 候 , 设置 外 键 的 可 选 值 (下 
拉 框 的 数据 内 容 ) 。 

函数 save_ model 是 在 新 增 或 修改 数据 的 时 候 , 单 击 “ 保 存 ” 按钮 所 触发 的 功能 ， 
该 函数 主要 对 输入 的 数据 进行 入 库 和 更 新 处 理 。 

自 定义 模板 通过 模板 继承 的 方法 实现 Admin 后 台 界 面 开 发 ， 可 以 根据 需求 改 
变 后 台 界 面 的 样式 和 功能 。 


Auth 认证 系统 


Django 除了 有 强大 的 Admin 管理 系统 之 外 ， 还 提供 了 完善 的 用 户 管理 系统 。 整 
个 用 户 管理 系统 可 分 为 三 大 部 分 : 用 户 信息 、 用 户 权限 和 用 户 组 ， 在 数据 库 中 分 别 对 
应 数据 表 auth_user、auth_permission 和 auth_group。 


9.1 内 置 User 实现 用 户 管理 


用 户 管理 功能 已 经 是 一 个 网 站 必 备 的 功能 之 一 ， 而 Django 内 置 了 强大 的 用 户 管 
理 系统 ， 并 且 具 有 灵活 的 扩展 性 ， 可 以 满足 多 方面 的 开发 需求 。 在 创建 Django 项 目 
时 ，Django 已 默认 使 用 内 置 用 户 管理 系统 ， 在 settings.py 的 INSTALLED _APPS、 
MIDDLEWARE 和 AUTH PASSWORD_ VALIDATORS 中 可 以 看 到 相关 的 配置 信息 。 


本 节 使 用 内 置 的 用 户 管理 系统 实现 用 户 的 注册 、 登 录 、 修 改 密码 和 注销 功能 。 以 
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MyDjango 为 例 ， 在 项 目 中 创建 新 的 App， 命 名 为 user， 并 且 在 项 目的 settings.py 和 
urls.py 中 配置 App 的 信息 ， 代 码 如 下 : 


# settings.py 配置 信息 

INSTALLED APPS = [ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
"django .contrib.messages'v 
"django .contrib .staticfiles'yv 
'index', 
'user', 


] 


# 文件 夹 MyDjango 的 urls .py 的 URL 地 址 配置 
from django.contrib import admin 
from django.urls import path,include 
urlpatterns = [ 
path('admin/', admin.site.urls), 
path('', include('index.urls')), 
path('user/', include('user.urls')) 


] 
完成 user 的 基本 配置 后 ,在 App 中 分 别 添加 urlspy 和 userhtml 文 件 , 如 图 9-1 所 示 。 





Y Duser 
> 名 migrations 
v Btemplates 
访 user.html 
访 _jinit_.py 
及 admin.py 
齐 apps.py 
阶 models.py 
篇 tests.py 
机 urls.py 
访 views.py 
访 manage.py 
图 9-1 项 目 目录 架构 























App 中 的 urls.py 主要 用 于 接收 和 处 理 根 目录 的 urls.py 的 请 求 信息 。 在 App 的 
urls.py 中 设 定 了 4 个 不 同 的 URL 地址 , 分别 代 表 用 户 登录 、 注 册 、 修 改 密码 和 用 户 注 销 ， 
代码 如 下 : 
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# urls.py 文 件 

# 设置 URL 地 址 信息 

from django.urls import path 

from . import views 

urlpatterns = [ 

path('login.html', views.loginView, name="'login’'), 
path('register.html', views.registerView, name='register'), 
path('setpassword.html', views.setpasswordView, name="'setpassword'), 
path('logout.html', views.logoutView, name='logout'), 


] 


上 述 URL 地 址 分 别 对 应 视图 函数 loginView、registerView、setpasswordView 和 
logoutView; 参数 name 用 于 设置 URL 的 命名 ， 可 直接 在 HTML 模板 上 使 用 并 生成 相 
应 的 URL 地 址 。 在 讲解 视图 函数 之 前 ， 首 先 了 解 HTML 模板 的 代码 结构 ， 代 码 如 下 : 


# user.html 文件 
# 用 户 登 录 、 注 册 和 修改 密码 界面 
<!DOCTYPE html> 
<html lang="zh-cn"> 
<head> 

<meta charset="utf-8"> 

<title>{{ title }}</title> 

<link rel="stylesheet" href="https://unpkg.com/mobi.css/dist/mobi. 

min.css"> 

</head> 
<body> 
<div class="flex-center"> 

<div class="container"> 

<div class ex-center"> 

<div class="unit-1-2 unit-1-on-mobile"> 

<hl>MyDjango Auth</hl> 
{% if tips %} 
<div>{{ tips }}</div> 
{% endif %} 
form" action="" method="post"> 








<form class: 
{% csrf token $%} 
<div> 用 户 名 :<input type="text" name='username'></div> 
<div> 密 码 :<input type="password" name='password'></div> 
{g% if new password %} 
<div> 新 密码 :<input type="password" name='new password'></ 
div> 
{% endif %} 
<button type="submit" class="btn btn-primary btn-block"> 确定 
</button> 
</form> 





<div class="flex-left top-gap text-small"> 
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<div class="unit-2-3"> 
<a href="{{ unit 2 }}">{{ unit 2 name }}</a> 
</div> 
<div class="unit-1-3 flex-right"> 
<a href="{{ unit 1 }}">{{ unit 1 name }}</a> 
</div> 
</div> 
</div> 
</div> 
</div> 
</div> 
</body> 
</html> 


一 个 模板 分 别 用 于 实现 用 户 登 录 、 注 册 和 修改 密码 ， 该 模板 是 由 两 个 文本 输入 框 





























和 一 个 按钮 所 组 成 的 表单 ， 在 该 表单 下 分 别 设 MyDjango Auth 
置 不 同 链接 ， 分 别 指向 另外 两 个 URL 地 址 ， 用 户 各 : 
如 图 9-2 所 示 。 二 
当 用 户 输入 账号 和 密码 之 后 , 单 击 “ 确 定 ” 
按钮 ， 就 会 触发 一 个 POST 请 求 ， 该 请 求 将 表 确 这 
单数 据 发 送 到 当前 的 URL 地址， 再 由 相应 的 | > 于吉 人 
视图 函数 进行 处 理 ， 并 将 处 理 结果 返回 到 浏览 图 9.2 模板 界面 
器 上 生成 相应 的 网 页 。 
了 解 URL 和 模板 文件 的 配置 后 ， 接 下 来 在 views.py 中 实现 用 户 登 录 功 能 ， 视 图 














函数 loginView 的 代码 如 下 : 


from django.shortcuts import render,redirect 
from django.contrib.auth.models import User 
from django.contrib.auth import login, logout, authenticate 
# Create your views here. 
def loginView (request): 
# 设置 标题 和 另外 两 个 URL 链接 
title = ' 登录， 
unit 2 = '/user/register.html' 
unit 2_name = ' 立即 注册 ' 
unit 1 = '/user/setpassword.html' 
unit 1 name =' 修改 密码 ' 
if request.method == "POST' : 
username = request.POST.get ('username', "'') 
password = request.POST.get ('password', "'') 
if User.objects .filter (username=username): 
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user = authenticate (username=username, password=password) 
if ser: 

if user.is active: 

login(request, user) 

return redirect('/') 
else: 

tips = ' 账号 密码 错误 ， 请 重新 输入 ' 

el3e: 

tips = ' 用 户 不 存在 ， 请 注册 ，' 


return render(request, 'user.html', locals()) 


上 述 代 码 结合 模板 文件 userhtml 的 变量 进行 分 析 ， 分 析 如 下 : 


@ 首先 设置 模板 变量 title 和 unit 2 等 变量 值 ， 在 模板 中 生成 相关 的 URL 地 址 ， 
可 以 从 登录 界面 跳 到 注册 界面 或 修改 密码 界面 。 

e@ ”由 于 提交 表单 是 由 当前 的 URL 执行 处 理 的 ， 因 此 函数 loginView 需要 处 理 不 
同 的 请 求 方式 ， 视 图 函数 首先 判断 当前 请 求 方式 。 如 果 是 POST 请 求 ， 则 获 
取 表 单 中 两 个 文本 框 的 数据 内 容 ， 分 别 为 usemame 和 password， 然 后 对 模型 
User 中 的 数据 进行 判断 和 了 验证， 只 有 验证 成 功 之 后 ， 网 页 才 会 跳 转 到 首页 ， 
否则 在 登录 界面 上 提示 错误 信息 。 

e@ 如果 是 GET 请 求 ， 当 完成 模板 变量 赋值 之 后 就 不 再 做 任何 处 理 ， 直 接 将 模板 
userhtml 生成 HTML 网 页 返回 到 浏览 器 上 。 


在 整个 登录 过 程 中 ， 我 们 并 没有 对 模型 User 进行 定义 ， 而 函数 中 使 用 的 模型 





User 来 自 于 Django 的 内 置 模型 , 在 数据 库 中 对 应 的 数据 表 为 auth_user, 如 图 9-3 所 示 。 








围 auth IL_group 
围 auth_group_permissions 
auth_permission 
























auth_user_groups 
auth_user_user_permissions 
django_admin_log 
django_content type 
django_migrations 
django_session 
index_product 

index type 
















































































可 症 困 两 亲 

















图 9-3 项 目 MyDjango 数据 表 


打开 数据 表 auth_user, 可 以 通过 表 字 段 的 命名 了 解 模 型 字段 的 含义 , 如 图 9-4 所 示 。 
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id password lastlogin is superuser username firstname last name email is staf is active datejoined 
1 pbkdf2_sha2:2018-03-15 1 root 554301< 1 1 2018-03-12 02: 
4 pbkdf2 sha2' 2018-03-14 0 user1 1 1 2018-03-12 09: 


图 9-4 数据 表 auth_user 的 字段 信息 























Diango 默认 的 模型 User 共 定 义 了 11 个 字段 ， 各 个 字段 的 含义 说 明 如 表 9-1 所 示 。 
表 9-1 User 模 型 各 个 字段 的 说 明 
字段 说 明 
int 类 型 ， 数 据 表 主键 
varchar 类 型 ， 代 表 用 户 密码 ， 在 默认 情况 下 使 用 pbkdf2_sha256 方 式 
来 存储 和 管理 用 户 的 密码 
last_login datetime 类 型 ， 最 近 一 次 登录 的 时 间 
is_superuser tinyint 类 型 ， 表 示 该 用 户 是 否 拥 有 所 有 的 权限 ， 即 是 否 为 超级 用 户 
Username varchar 类 型 ， 代 表 用 户 账号 
first name varchar 类 型 ， 代 表 用 户 的 名 字 
last_name varchar 类 型 ， 代 表 用 户 的 姓氏 
Email varchar 类 型 ， 代 表 用 户 的 邮件 
is_staff 用 来 判断 用 户 是 否 可 以 登录 进入 Admin 系 统 
is_active tinyint 类 型 ， 用 来 判断 该 用 户 的 状态 是 否 被 激活 
date_ joined datetime 类 型 ， 账 号 的 创建 时 间 


浊 
学 


Password 








我 们 结合 函数 loginView 和 模型 User 的 字段 含义 ， 进 一 步 分 析 函 数 loginView 的 
代码 功能 : 


。 当 函 数 loginView 收 到 POST 请 求 并 获取 表单 的 数据 后 ， 根 据 表单 的 数据 判断 
用 户 是 否 存在 。 当 用 户 存在 时 ， 对 用 户 的 账号 和 密码 进行 验证 处 理 ， 由 内 置 
函数 authenticate 完成 验证 功能 ， 如 果 验 证 成 功 ， 函 数 authenticate 返回 模型 
Uesr 的 数据 对 象 user， 否 则 返回 None。 

e@ 然后 从 对 象 User 的 is_active 字 段 来 判断 当前 用 户 的 状态 是 否 被 激活 ， 如 果 为 1， 
说 明 当 前 用 户 处 于 激活 状态 ， 可 执行 用 户 登 录 。 

e 最 后 执行 用 户 登 录 , 由 内 置 函数 login 完成 登录 过 程 。 函 数 login 接收 两 个 参数 ， 
第 一 个 是 request 对 象 ， 来 自视 图 函数 的 参数 request; 第 二 个 是 user 对 象 ， 来 
自 函 数 authenticate 返回 的 对 象 user。 
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从 整个 登录 过 程 中 可 以 发 现 ，Django 为 我 们 提供 了 完善 的 内 置 函 数 ， 可 快速 
实现 用 户 登 录 功 能 。 为 了 更 好 地 演 运 行 结果 ， 在 index 中 分 别 对 模板 index.html 的 
<header> 标签 和 视图 函数 index 进行 修改 ， 代 码 如 下 : 





























# 模板 index.html 的 <header> 标签 
<header id="top"> 
<!-- 内 容 显 示 区 域 : width : 1211px --> 
<div id="top box"> 
<ul class="]lf"> 
<1i><a href="#"> 华为 官网 </a></1i> 
<1i><a href="#"> 华为 荣耀 </a></1i> 
</ul> 
<ul class="rt"> 
{$ if username %} 
<1i> 用 户 名 : {{ username }}</1Li> 
<li><a href="{% url 'logout' $}"> 退出 登录 </a></1i> 
{% else $%} 
<li><a href="{% url 'login' $%}"> 登录 </a></1i> 
<li><a href="{% url 'register' %}"> 注 册 </a></1i> 
{% endif %} 
</ul> 
</div> 
</header> 








# views .py 的 视图 函数 index 
def index (request) : 
# 获取 当前 请 求 的 用 户 名 
username = request.user.username 
return render(request, '‘'index.html', locals()) 


在 浏览 器 上 访问 http://127.0.0.1:8000/user/login.html， 在 用 户 登录 界面 输入 用 户 的 
账号 和 密码 ， 然 后 单 击 “ 确 定 ” 按 钮 ， 将 输入 的 用 户 信 息 提交 到 视图 函数 loginView 
中 完成 登录 过 程 ， 运 行 结果 如 图 9-4 所 示 。 
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图 9-4 用 户 登 录 


























上 述 例 子 用 于 实现 用 户 登录 ， 接 下 来 完成 用 户 注 册 功 能 ， 用 户 注册 的 视图 函数 
为 registerView， 在 user 的 views.py 中 编写 函数 registerView， 代 码 如 下 : 
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def registerView (request): 


# 设置 标题 和 另外 两 个 URL 链接 
title = ' 注册，' 
unit 2 = '/user/login.html' 
unit 2_name = ' 立即 登录 ' 
unit 1 = '/user/setpassword.html' 
unit 1 name =' 修改 密码 ' 
IE request.method == "POST': 
Username = request.POST.get ('username', '') 
password = request.POST.get ('password', '') 
if User.objects .filter (username=username): 
tips = ' 用 户 已 存在 ' 
else: 
user = User.objects.create user (username=username, 


password=password) 


132 


user.save() 
tips = ' 注册 成 功 ， 请 登录 ' 


return Fender (request， 'user.html', locals()) 


从 上 述 代码 得 知 ， 用 户 注册 与 用 户 登 录 的 流程 大 致 相同 ， 具 体 说 明 如 下 : 


当 用 户 输入 账号 和 密码 并 单 击 “ 确 定 ” 按 钮 后 ， 程 序 将 表单 数据 提交 到 函数 
IegisterView 中 进行 处 理 。 

子 数 registerView 首先 获取 表单 的 数据 内 容 ， 根 据 获取 的 数据 来 判断 模型 User 
是 否 存 在 相关 的 用 户 信息 。 

如 果 用 户 存 在 ， 直 接 返 回 到 注册 界面 并 提示 用 户 已 存在 。 

如 果 用 户 不 存在 ， 程 序 使 用 内 置 函数 create_user 对 模型 User 进行 用 户 创 
建 ， 函 数 create user 是 模型 User 特有 的 函数 ， 该 函数 创建 并 保存 一 个 is_ 
active= True 的 User 对象 。 其 中 ， 函 数 参 数 usemame 不 能 为 空 ， 否 则 抛 出 
ValueError 异常 ， 而 模型 User 的 其 他 字段 可 作为 函数 create_user 的 可 选 参 
数 ， 如 email、first_name 和 password 等 。 如 果 使 用 过 程 中 没有 设置 函数 参数 
password， 则 User 对 象 的 set_unusable password() 函数 将 会 被 调用 ， 为 当前 
用 户 创建 一 个 随机 密码 。 


最 后 在 views.py 中 编写 函数 setpasswordView， 实 现 修改 用 户 密 码 的 功能 ， 代 码 
如 下 : 


def setpasswordView (request): 


# 设置 标题 和 另外 两 个 URL 链接 
title = ' 修改 密码 ' 
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unit 2 = '/user/login.html' 
unit 2 _name = ' 立即 登录 ' 
unit 1 = '/user/register.html' 
unit 1 name = "立即 注册 ， 
new password = True 
if request.method == 'POST': 
username = request.POST.get ('username', '') 


old password = request.POST.get ('password', '') 
new_ password = request.POST.get ('new password', '') 
if User.objects .filter (username=username): 
user = authenticate (username=username, password=old password) 
user.set password (new password) 
user.save() 
tips = ' 密码 修改 成 功 ' 
else: 
tips = ' 用 户 不 存在 ' 


return render(request, 'user.html', locals()) 
密码 修改 界面 相 比 注册 和 登录 界面 多 出 了 一 个 文本 输入 框 ， 该 文本 输入 框 由 模 
板 变 量 new_password 控制 显示 。 当 变量 new_password 为 True 时 ， 文 本 输入 框 将 显 
示 到 页 面 上 ， 如 图 9-5 所 示 。 








MyDjango Auth 


用 户 各 : 


了 加 登 受 立 色 注册 


图 9-5 密码 修改 界面 











函数 setpasswordView 的 处 理 逻辑 与 上 述 例 子 也 是 相似 的 , 函数 处 理 逻 辑 说 明 如 下 : 

8 当 浮 数 setpasswordView 收 到 表单 提交 的 请 求 后 ,程序 会 获取 表单 的 数据 内 容 ， 
然后 根据 表单 数据 查找 模型 User 相应 的 数据 。 

@ 如 果 用 户 存 在 ， 由 内 置 函 数 authenticate 验证 用 户 的 账号 和 密码 是 否 正确 ， 若 
验证 成 功 ， 则 返回 user 对 象 ， 再 使 用 内 置 函 数 set password 修改 对 象 user 的 
密码 ， 最 后 保存 修改 后 的 user 对 象 ， 从 而 实现 密码 修改 。 

@ ”如 果 用 户 不 存在 ， 直 接 返 回 到 界面 并 提示 用 户 不 存在 。 
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密码 修改 主要 由 内 置 函数 set password 实现 ， 而 函数 set password 是 在 内 置 函 
数 make_password 的 基础 上 进行 封装 而 来 的 。 我 们 知道 在 默认 情况 下 ，Django 使 用 
pbkdf2 sha256 方式 来 存储 和 管理 用 户 密码 ， 而 内 置 函数 make password 主要 实现 用 
户 密码 的 加 密 功 能 ， 并 且 该 函数 可 以 脱离 Auth 认证 系统 单独 使 用 ， 比 如 对 某 些 特殊 
数据 进行 加 密 处 理 等 。 在 上 述 例子 中 ， 使 用 函数 make_password 实现 密码 修改 ， 代 码 
如 下 : 


# 使 用 make_password 实现 密码 修改 
from django.contrib.auth.hashers import make password 
def setpasswordView 1 (request) : 
if request.method == 'POST': 
username = request.POST.get ('username', '') 
old password = request.POST.get ('password', '') 
new_ password = request.POST.get ('new password', '') 
# 判断 用 户 是 否 存在 
user = User.objects .filter (username=username) 
if User.objects .filter (username=username): 
user = authenticate (username=usernamerpassword=old password) 
# 密码 加 密 处 理 并 保存 到 数据 库 
dj ps = make password(new password, None, 'pbkdf2 sha256') 
user.password = dj ps 
user.save() 
return render(request, 'user.html', locals()) 


除了 内 置 函数 make_password 处 ， 还 有 内 置 函 数 check_password， 该 函数 是 对 加 
密 前 的 密码 与 加 密 后 的 密码 进行 验证 匹配 ， 判 断 两 者 是 否 为 同一 个 密码 。 在 PyCharm 
的 Terminal 中 开启 Django 的 shell 模式 ， 函 数 make_password 和 check_password 的 使 
用 方法 如 下 : 


E:\MyDjango>python manage.py shell 

>>> from django.contrib.auth.hashers import make password, check password 

>>> ps = "123456" 

>>> dj _ps = make password(ps, None, 'pbkdf2 sha256') 

>>> dj_ps 

'pPbkdf2_ sha256$100000$NgVcn5EaZPZe$klgPF2gKdG09JuLdIIdNTX5EUOKj/ 
krR1riVr2eAjVE=" 

>>> ps_bool = check password(ps, dj ps) 

>>> ps_bool 

True 


上 述 例 子 中 分 别 讲述 了 用 户 登录 、 注 册 和 密码 修改 的 实现 过 程 ， 最 后 只 剩 下 用 
户 注 销 ， 用 户 注销 是 用 户 管理 系统 较为 简单 的 功能 ， 调 用 内 置 函数 logout 即 可 实现 。 
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函数 logout 接收 参数 request， 代 表 当 前 用 户 的 请 求 对 象 ， 来 自 于 视图 函数 的 参数 
request。 因 此 ， 视 图 函数 logoutView 的 代码 如 下 : 





# 用 户 注销 ， 退 出 登录 

def logoutView (request): 
logout (request) 
return redirect('/') 


9.2 发 送 邮 件 实现 密码 找 回 


在 9.1 节 中 ， 密 码 修改 是 在 用 户 知道 密码 的 情况 下 实现 的 ， 而 在 日 常 应 用 中 ， 还 
有 一 种 是 在 用 户 忘记 密码 的 情况 下 实现 密码 修改 ， 也 称 为 密码 找 回 。 密 码 找 回 首先 需 
要 对 用 户 账号 进行 验证 ， 确 认 该 账号 是 当前 用 户 所 拥有 的 ， 验 证 成 功 后 才能 给 用 户 重 
置 密码 。 用 户 验证 方式 主要 有 手机 验证 码 验证 和 邮箱 验证 码 验 证 两 种 ， 因 此 本 章 使 用 
Django 内 置 的 邮件 功能 实现 邮箱 验证 ， 从 而 实现 密码 找 回 功能 。 

在 实现 邮件 发 送 功能 之 前 ， 我 们 需要 对 邮箱 进行 相关 配置 ， 以 QQ 邮箱 为 例 ， 
在 QQ 邮箱 的 设置 中 找到 账户 设置 ， 在 账户 设置 中 找到 POP3/IMAP/SMTP/Exchange/ 
CardDAV/CalDAV 服务 ， 然 后 开启 POP3/SMTP 服务 ， 如 图 9-6 所 示 。 

























































































POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV 服 务 





IMAP/SMTP 骤 务 (什么 是 IMAP ， 它 又 插 如 何 设置 ?) 

Exchange 服 务 (什么 是 Exchange , 它 又 是 如 何 设置 ?) 
CardDAV/CalDAV 服 务 (什么 是 CardDAV/CalDAV ， 它 又 插 如 何 没 置 ? ) 
(POP3/IMAP/SMTP/CardDAV/CalDAV 屎 务 均 支 持 SSL 注 接 。 如 何 设 置 ? ) 














图 9-6 开启 POP3/SMTP 服务 














值得 注意 的 是 ， 开 启 服务 时 ，QQ 邮箱 会 返回 一 个 客户 端 授权 密码 ， 该 密码 是 用 
于 登录 第 三 方 邮件 客户 端的 专用 密码 ， 切 记 保 存 授 权 密 码 ， 该 密码 在 开发 过 程 中 需要 
使 用 












































本 例 中 ， 我 们 使 用 QQ 邮箱 给 用 户 发 送 验证 邮件 ， 因 此 在 Django 的 settings.py 
中 添加 QQ 邮箱 的 相关 配置 ， 配 置信 息 如 下 : 





# 邮件 配置 信息 


EMAIL USE SSL = True 
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# 邮件 服务 器 ， 如 果 是 163 就 改 成 smtp .163 .com 
EMAIL HOST = 'smtp.qq.com" 

# 邮件 服务 器 端口 

EMAIL PORT = 465 

# 发 送 邮 件 的 账号 

EMAIL HOST USER = '185231027@qq.com' 

# SMTP 服务 密码 

EMAIL HOST PASSWORD = 'sgqcmjaxxxxxx"' 
DEFAULT FROM EMAIL = EMAIL HOST USER 


上 述 配 置 是 邮件 发 送 方 的 邮件 服务 器 信息 ， 各 个 配置 信息 说 明 如 下 。 


。 EMAIL USE SSL: 设置 Django 与 邮件 服务 器 的 连接 方式 为 SSL。 
。 EMAIL HOST: 设置 服务 器 的 地 址 ， 该 配置 使 用 SMTP 服务 器 。 


e ”EMAIL PORT: 设置 服务 器 端口 信息 ， 若 使 用 SMTP 服务 器 ， 则 端口 应 为 
465 或 587。 


。 EMAIL HOST_USER: 发 送 邮件 的 账号 ， 该 账号 必须 开启 POP3/SMTP 服务 。 


e “EMAIL HOST PASSWORD: 客户 端 授权 密码 ， 即 图 9-6 开启 服务 后 所 获得 
的 授权 码 。 


e DEFAULT FROM _EMAIL: 设置 默认 发 送 邮 件 的 账号 。 


完成 邮箱 相关 配置 后 ， 我 们 在 user 的 urlspy、 模 板 userhtml 和 views.py 中 编写 
实现 代码 ， 代 码 如 下 : 


# urls.py 代码 

from django.urls import path 

from . import views 

urlpatterns = [ 

path('findPassword.html', views.findPassword, name='findPassword'), 


] 


# 模板 user.html 
<!DOCTYPE html> 
<html lang="zh-cn"> 
<head> 
<meta charset="utf-8"> 
<title> 找 回 密码 </title> 
<link rel="stylesheet" href="https://unpkg.com/mobi.css/dist/mobi. 














min.css"> 


</head> 
<body> 
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<div class="flex-center"> 
<div class="container"> 
<div clas 





flex-center"> 





<div class="unit-1-2 unit-1-on-mobile"> 
<hl>MyDjango Auth</h1> 
{SE 和 4ps, SE 
<div>{{ tips }}</div> 
{$% endif %} 
<form class="form" action="" method="post"> 
{% csrf token %} 


Auth 认证 系统 





<div> 用 户 名 :<input type="text" name='username' value 


“tt 


username }}"></div> 


div> 


<div> 验证 码 :<input type="text" name='VerificationCode'></div> 
{% if new password %} 


<div> 新 密码 :<input type="password" name='new password'></ 


{% endif %} 
<button type="submit" class="btn btn-primary btn-block">{{ 


button }}</button> 


</form> 
</div> 
</div> 
</div> 
</div> 
</body> 
</html> 


# views .py 的 视图 函数 findPassword 

import random 

from django.shortcuts import render 

from django.contrib.auth.models import User 

from django.contrib.auth.hashers import make password 


# 找 回 密码 
def findPassword (request): 
button = ' 获取 验证 码 ' 
new_password = False 
if request.method == 'POST': 
username = request.POST.get('username', 'root') 
VerificationCode = request.POST.get ('VerificationCode', 
password = request.POST.get ('password', '') 
user = User.objects .filter (username=username) 
# 用 户 不 存在 
if not user: 
tips = ' 用 户 ' + username + ' 不 存在 ' 
else: 


# 判断 验证 码 是 否 已 发 送 


1) 
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if not request.session.get('VerificationCode', ''): 
# 发 送 验证 码 并 将 验证 码 写 入 session 
button = ' 重 置 密码 ' 
tips = ' 验证 码 已 发 送 " 
new password = True 
VerificationCode = strl(random.randint (1000, 9999)) 
request.session['VerificationCode'] = VerificationCode 
user[0] .email user(' 找 回 密码 '，vVerificationCode) 

# 匹配 输入 的 验证 码 是 否 正确 

elif VerificationCode == request.session. 

get ('VerificationCode'): 

# 密码 加 密 处 理 并 保存 到 数据 库 
dj ps = make password(password, None, 'pbkdf2 sha256') 
user[0] .password = dj ps 
user[0] .save() 
del request.session['VerificationCode'] 
tips = ' 密码 已 重 置 ' 

# 输入 验证 码 错误 

else: 
tips = ' 验证 码 错误 ， 请 重新 获取 ' 
new_password = False 
del request.session['VerificationCode'] 

return render(request, 'user.html', locals()) 


用 户 第 一 次 访问 http://127.0.0.1:8000/user/findPassword.html 的 时 候 ， 触 发 了 GET 
请 求 ， 视 图 函数 fndPassword 直接 将 模板 userhtml 返回 ， 如 图 9-7 所 示 。 

当 输 入 用 户 名 并 单 击 “ 获 取 验 证 码 ”按钮 的 时 候 ， 触 发 了 POST 请 求 ， 视 图 函数 
findPassword 首先 根据 用 户 输入 的 用 户 名 和 模型 User 里 的 数据 进行 查找 ， 判 断 用 户 名 
是 否 存在 ， 若 不 存在 ， 则 会 生成 提示 信息 ， 如 图 9-8 所 示 。 






































MyDjango Auth MyDjango Auth 
用 户 名 : 用 户 user 不 存在 
用 户 名 : 











图 9-7 密码 找 回 的 网 页 信息 图 9-8 用 户 不 存在 














如 果 用 户 存在 ， 接 着 判断 会 话 session 的 VerificationCode 是 否 存在 。 若 不 存 
在 ， 则 视图 函数 findPassword 通过 发 送 邮 件 的 方式 将 验证 码 发 到 该 用 户 的 邮箱 ， 
验证 码 是 使 用 random 模块 随机 生成 的 4 位 数 ， 然 后 将 验证 码 写 入 会 话 session 的 
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VerificationCode， 其 作用 是 与 用 户 输入 的 验证 码 进行 匹配 。 邮 件 发 送 是 由 内 置 函 数 
email user 实现 的 ， 该 方法 是 模型 User 特有 的 方法 之 一 ， 只 适用 于 模型 User。 需 要 注 
意 的 是 ， 用 户 的 邮箱 来 自 于 模型 User 的 字段 email， 如 果 当 前 用 户 的 邮箱 信息 为 空 ， 
邮件 是 无 法 发 送出 去 的 。 邮 件 发 送 如 图 9-9 所 示 。 
































D sms x 
€ 了 © [© 12700ta000/user/indpassword tm 
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验证 机 已 发 


用 户 各 : 


root 


验证 枉 : 





图 9-9 邮件 发 送 

















目 户 接收 到 验证 码 之 后 ， 可 在 网 页 上 输入 验证 码 ， 然 后 单 击 “ 重 置 密码 ”按钮 ， 
这 时 会 触发 POST 请 求 ， 函 数 fndPassword 获取 用 户 输入 的 验证 码 并 与 会 话 session 的 
VerificationCode 进行 对 比 ， 如 果 两 者 不 符合 ， 说 明 用 户 输入 的 验证 码 与 邮件 中 的 验证 
码 不 一 样 ， 系 统 提示 验证 码 错误 ， 如 果 9-10 所 示 。 





MyDjango Auth 
验证 码 漠 误 ， 语 重新 获取 
用 户 名 : 


验证 码 : 





图 9-10 验证 码 错误 














若 用 户 输入 的 验证 码 与 会 话 session 的 VerificationCode 相符 合 ， 那 么 程序 会 执行 
密码 修改 。 首 先 会 获取 用 户 输入 的 密码 ， 然 后 使 用 函数 make_password 对 密码 加 密 处 
理 并 保存 在 模型 User 中 ， 最 后 删除 会 话 session 的 VerificationCode， 和 否则 会 话 session 
一 直 存 在 ,在 下 次 获取 验证 码 时 , 程序 不 会 执行 邮件 发 送 功能 。 运 行 结 果 如 图 9-11 所 示 。 
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图 9-11 重 置 密 码 




















除了 使 用 内 置 函 数 email_user 实现 邮件 发 送 之 外 ，Django 还 另外 提供 多 种 邮件 发 








法 。 我 们 在 Django 的 shell 模式 下 进行 讲解 ， 代 码 如 下 : 


E:\MyDjango>python manage.py shell 

# 使 用 send_mail 实现 邮件 发 送 

>>> from django.core.mail import send mail 
>>> from django.conf import settings 

# 获取 settings .py 的 配置 信息 

>>> from email = settings.DEFAULT FROM EMAIL 
# 发 送 邮 件 ， 接 收 邮件 以 列表 表示 ， 说 明 可 设置 多 个 接收 对 象 


>>> send mail('MyDjango', 'This is Django', from email, ['554301449@ 
qq.com']) 


1 


# 使 用 send_mass_mail 实现 多 封 邮件 同时 发 送 


>>> from django.core.mail import send mass mail 


>>> messagel = ('MyDjango', 'This is Django', from email, ['554301449@ 
qq.com']) 
>>> message2 = ('MyDjango', '‘'Hello Django', from email, ['554301449@ 
qq.com']) 


>>> send mass mail((messagel, message?2), fail silently=False) 
2 


# 使 用 EmailMultiAlternatives 实现 邮件 发 送 

>>> from django.core.mail import EmailMultiAlternatives 

>>> content = '<p> 这 是 一 封 <strong> 重要 的 </strong> 邮件 。</p>' 

>>> msg = EmailMultiAlternatives('MyDjango', content, from email, 


['554301449@qq.com']) 


# 将 正文 设置 为 HTML 格式 
>>> msg.content subtype = 'html' 
# attach alternative 对 正文 内 容 进行 补充 和 添加 


>>> msg.attach alternative('<strong>This is from Django</strong>" 





html') 


# 添加 附件 (可 选 》 
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>>> msg.attach file('E://attachfile.csv') 
# 发 送 


>>> msg.send() 


8 


上 述 例 子 中 分 别 讲述 了 send mail、send mass _mail 和 EmailMultiAlternatives 的 
使 用 方法 ， 方 法 说 明 如 下 : 


使 用 send mail 每 次 发 送 邮 件 都 会 建立 一 个 新 的 连接 ， 如 果 发 送 多 封 邮件 ， 就 
需要 建立 多 个 连接 。 

send mass_ mail 是 建立 单个 连接 发 送 多 封 邮 件 ， 所 以 一 次 性 发 送 多 封 邮 件 时 ， 
send mass_mail 要 优 于 send_mail。 

EmailMultiAlternatives 比 前 面 两 者 更 为 个 性 化 ， 可 以 设置 邮件 正文 内 容 为 
HTML 格式 ， 也 可 以 在 邮件 上 添加 附件 ， 满 足 多 方面 的 开发 需求 。 


9.3 扩展 User 模型 


在 开发 过 程 中 ， 模 型 User 的 字段 可 能 满足 不 了 复杂 的 开发 需求 。 现 在 大 多 数 网 
站 的 用 户 信息 都 有 用 户 的 手机 号 码 、QQ 号 码 和 微 信 号 码 等 一 系列 个 人 信息 。 为 了 满 
足 各 种 需求 ，Django 提供 了 4 种 模型 扩展 的 方法 。 


代理 模型 : 这 是 一 种 模型 继承 ， 这 种 模型 在 数据 库 中 无 须 创 建新 数据 表 。 一 
般 用 于 改变 现 有 模型 的 行为 方式 ， 如 增加 新 方法 函数 等 ， 并 且 不 影响 现 有 数 
据 库 的 结构 。 当 不 需要 在 数据 库 中 存储 额外 的 信息 ， 而 需要 增加 操作 方法 或 
更 改 模型 的 查询 管理 方式 时 ， 适 合 使 用 代理 模型 来 扩展 现 有 User 模型 。 
Profile 扩展 模型 User: 当 存 储 的 信息 与 模型 User 相关 ， 而 且 并 不 改变 模 
型 User 原 有 的 认证 方法 时 ， 可 定义 新 的 模型 MyUser， 并 设置 某 个 字段 为 
OneToOneField， 这 样 能 与 模型 User 形成 一 对 一 关联 ， 该 方法 称 为 用 户 配置 
(User Profile) 。 

AbstractBaseUser 扩展 模型 User， 当 模 型 User 的 内 置 方法 并 不 符合 开发 需求 时 ， 
可 使 用 该 方法 对 模型 User 重新 自 定 义 设 计 ， 该 方法 对 模型 User 和 数据 库 架 
构 影 响 很 大 。 

AbstractUser 扩展 模型 User: 如 果 模 型 User 内 置 的 方法 符合 开发 需求 ， 在 不 
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改变 这 些 函 数 方法 的 情况 下 ， 添 加 模型 User 的 额外 字段 ， 可 通过 AbstractUser 
方式 实现 。 使 用 AbstractUser 定义 的 模型 会 替换 原 有 模型 User。 


上 述 4 种 方法 各 有 优 缺 点 ， 一 般 情 况 下 ， 建 议 使 用 AbstractUser 扩展 模型 User， 
因为 该 方式 对 原 有 模型 User 影响 较 少 而 且 无 须 额 外 创建 数据 表 。 下 面 以 MyDjango 
项 目 为 例 讲 解 如 何 使 用 AbstractUser 扩展 模型 User。 首 先 在 MySQL 中 找到 项 目 所 使 
用 的 数据 库 ， 并 清除 该 数据 库 中 全 部 的 数据 表 ， 在 user 的 models.py 文件 中 定义 模型 
MyUser， 代 码 如 下 : 


# models.py 
from django.db import models 
from django.contrib.auth.models import AbstractUser 
class MyUser (AbstractUser): 
qq = models.CharField('QQ 号 码 '， max_ length=16) 
weChat = models .CharField(' 微 信 账号 '， max_ length=100) 
mobile = models.CharField(' 手机 号 码 '， max_ length=11) 
# 设置 返回 值 
def _ str_ (self): 
return self.username 


模型 MyUser 继承 自 AbstractUser 类 ，AbstractUser 类 已 有 内 置 模型 User 的 字段 
属性 ， 因 此 模型 MyUser 具有 模型 User 的 全 部 属性 。 在 执行 数据 迁移 〈 创 建 数据 表 ) 
之 前 ， 必 须要 在 项 目的 settings.py 中 配置 相关 信息 ， 配 置信 息 如 下 : 


# settings.py 
AUTH_USER MODEL = "user.MYUser' 


配置 信息 是 将 内 置 模 型 User 替换 成 user 定义 的 模型 MyUser， 若 没有 设置 配置 信 
息 ， 在 创建 数据 表 的 时 候 ， 会 分 别 创建 数据 表 auth_user 和 user myuser。 在 PyCharm 
的 Terminal 下 执行 数据 迁移 ， 代 码 如 下 : 
E:\MyDjango>python manage.py makemigrations 
Migrations for 'user': 
user\migrations\0002 auto 20180320 1512.py 


- Alter field mobile on myuser 
- Alter field qq on myuser 


E:\MyDjango>python manage.py migrate 


完成 数据 迁移 后 ， 打 开 数 据 库 查看 数据 表 信 息 ， 可 以 发 现 内 置 模型 User 的 数据 
表 auth_user 改 为 数据 表 user myuser， 并 且 数 据 表 user myuser 的 字段 除了 具有 内 置 
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模型 User 的 字段 之 外 ， 还 额外 增加 了 自 定 义 的 字段 ， 如 图 9-12 所 示 。 


将 过 和 二 看 BD 二 
异 和 事务。 国 各 注 " 可 入 下 肚 排 序 七 SA 四 SE 


id password lastJogin issuperuser usemame firstname lastname email isstaff isactive datejoined qq weChat mobile 





图 9-12 数据 表 user_myuser 














上 述 例 子 使 用 AbstractUser 扩展 模型 User， 实 现 过 程 可 分 为 两 个 步 又， 








。 定义 新 的 模型 MyUser， 该 模型 必须 继承 AbstractUser 类 ， 在 模型 MyUser 下 
定义 的 字段 为 扩展 字段 。 

e@ 在 项 目的 配置 文件 settings.py 中 配置 AUTH USER_MODEL 信息 ， 在 数据 迁 
移 时 ， 将 内 置 模型 User 替换 成 user 定义 的 模型 MyUser。 


完成 模型 User 的 扩展 后 ， 接 着 探讨 模型 MyUser 与 内 置 模型 User 在 实际 开发 过 
程 中 是 否 存在 使 用 上 的 差异 。 首 先 使 用 python manage.py createsuperuser 创建 超级 用 
户 并 登录 Admin 后 台 管理 系统 ， 如 图 9-13 所 示 。 

















图 9-13 Admin 后 台 管 理 系统 


从 图 9-13 中 发 现 ， 认 证 与 授权 没有 用 户 信 息 表 ， 因 为 模型 MyUser 是 在 user 的 
models.py 中 定义 的 。 若 将 模型 MyUser 展示 在 后 台 系 统 ， 则 可 以 在 user 的 admin.py 
中 定义 相关 数据 对 象 ， 代 码 如 下 : 





# admin .py 
from django.contrib import admin 
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from .models import MyUser 
from dijango.contrib.auth.admin import UserAdmin 
from django.utils.translation import gettext lazy as _ 
@admin.register (MyUser) 
class MyUserAdmin (UserAdmin): 
list display = ['username','email', 'mobile','qq', 'weChat'] 
# 修改 用 户 时 ， 在 个 人 信息 里 添加 'mobile'、'qq'、'weCchat"' 的 信息 录入 
# 将 源码 的 UserAdmin.fieldsets 转换 成 列表 格式 
fieldsets = list(UserAdmin .fieldsets) 
# 重 写 UserAdmin 的 fieldsets， 添 加 'mobile'、'qq'、'weChat' 的 信息 录入 
fieldsets[1] = ( ('Personal info'), 


{'fields': ('first name', 'last name', ‘'email', 'mobile', ‘'qq', ‘'weChat')}) 


# _ init .py 

# 设置 App (user) 的 中 文 名 

from django.apps import AppConfig 
import os 

# 修改 app 在 admin 后 台 显示 名 称 

# default app_config 的 值 来 自 apps .py 的 类 名 
default app_config = "user.IndexConfig' 


# 获取 当前 app 的 命名 
def get current app name( file): 
return os.path.split(os.path.dirname ( file)) [-1] 


# 重 写 类 IndexConfig 

class IndexConfig (APPConfig) : 
name = get_current app name(_file_ ) 
verbose_name = ' 用 户 管理 ' 


重启 MyDiango 项 目 并 进入 Admin 后 台 管 理 系统 ， 可 以 在 界面 上 看 到 模型 
MyUser 所 生成 的 用 户 信息 表 ， 如 图 9-14 所 示 。 








图 9-14 Admin 后 台 管理 系统 界面 
































进入 用 户 信息 表 并 修改 某 个 用 户 信息 的 时 候 ， 发 现 用 户 信息 的 修改 界面 出 现 用 户 
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的 手机 号 码 、QQ 号 码 和 微 信 号 码 的 文本 输入 框 ， 这 是 由 MyUserAdmin 类 中 重 写 属性 
fieldsets 实现 的 ， 如 图 9-15 所 示 。 



































图 9-15 修改 用 户 信息 

















上 述 例子 中 ，adminpy 定义 的 MyUserAdmin 继承 自 UserAdmin，UserAdmin 
是 内 置 模型 User 的 Admin 数据 对 象 ， 源 码 可 在 Python 安装 目录 Lib\site-packages\ 
djangovcontrib\authvadmin py 中 查看 。 因 此 ， 在 定义 MyUserAdmin 时 ， 直 接 继承 
UserAdmin， 并 通过 重 写 某 些 属性 ， 可 以 快速 开发 扩展 模型 MyUser 的 Admin 后 台数 
据 对 象 。 

除了 继承 UserAdmin 的 Admin 数据 对 象 之 外 ， 还 可 以 在 表单 中 继承 内 置 模型 
User 所 定义 的 表单 类 。 内 置 表单 类 可 以 在 Python 安装 目录 Lib\site-packages\django\ 
contrib\auth\forms.py 下 查看 源码 。 从 源码 中 发 现 ，forms.py 定义 了 多 个 内 置 表单 类 ， 
其 说 明 如 表 9-2 所 示 。 











表 9-2 forms.py 的 内 置 表单 类 









































表单 类 表单 字段 说 明 

UserCreationForm username, passwordl, password2 创建 新 的 用 户 信 息 

UserChangeForm password， 模 型 User 全 部 字段 修改 已 有 的 用 户 信息 

AuthenticationForm username, password 录 时 所 触发 的 认 

PasswordResetForm email 人 0 人 送 邮 
修改 或 新 增 用 户 密码 ， 

SetPasswordForm passwordl, password2 设置 密码 时 ， 无 须 对 旧 
密码 进行 验证 
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〈 续 表 ) 
表单 类 表单 字段 说 明 
old password, new_ passwordl 于 寺 SetpasswerdFomy 
PasswordChangeForm ne a 卫 修改 密码 前 需要 对 旧 密 
二 码 进行 验证 
用 于 Admin 后 台 修 改 用 


AdminPasswordChangeForm password1，password2 户 密码 





从 上 述 内 置 的 表单 类 可 以 发 现 ， 这 些 表单 类 都 涉及 模型 User 的 字段 ， 这 说 明 
这 些 表单 都 是 在 内 置 模型 User 的 基础 上 实现 的 。 因 此 ， 我 们 为 扩展 模型 MyUser 定 
义 相 关 的 表单 类 可 以 继承 上 述 的 表单 类 。 以 UserCreationForm 为 例 ， 使 用 表单 类 
UserCreationForm 实现 用 户 注 册 功 能 。 在 user 中 创建 form.py 文件 ， 并 在 文件 下 编写 
以 下 代码 : 


# form.py 
from django.contrib.auth.forms import UserCreationForm 
from .models import MyUser 


class MyUserCreationForm(UserCreationForm): 
class Meta(UserCreationForm.Meta): 
model = MyUser 
# 在 注册 界面 添加 邮箱 、 手 机 号 码 、 微 信号 码 和 8Q 号 码 
fields = UserCreationForm.Meta.fields + ('email', '‘'mobile', 
'weChat', 'qgqq') 


自 定义 表单 类 MyUserCreationForm 继承 自 表单 类 UserCreationForm， 并 且 重 写 
类 Meta 的 属性 model 和 属性 fields， 分 别 重 新 设置 表单 类 所 绑 定 的 模型 和 字段 。 然 后 
在 模板 userhtml 和 视图 函数 registerView 中 编写 以 下 代码 ， 代 码 如 下 : 


# 模板 user.html 

<!DOCTYPE html> 

<html lang="zh-cn"> 

<head> 
<meta charset="utf-8"> 
<title> 用 户 注册 </title> 
<link rel="stylesheet" href="https://unpkg.com/mobi.css/dist/mobi. 

min.css"> 

</head> 

<body> 

<div class="flex-center"> 
<div class="container"> 
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<div class="flex-center"> 
<div class="unit-1-2 unit-1-on-mobile"> 
<hl>MyDjango Ruth</h1> 
{% if£ tips 多 } 
<div>{{ tips }}</div> 
{% endif %} 
<form class="form" action="" method="post"> 
{$$ csrf token %} 
<div> 用 户 名 :{{ user.username }}</div> 
<div> 邮 箱 :{{ user.email }}</div> 
<div> 手 机 号 :{{ user.mobile }}</div> 
<div>Q Q 号 :{{ user.qq }}</div> 
<div> 微 信号 :{{ user.weCchat }}</div> 
<div> 密 码 :{{ user.passwordl }}</div> 
<div> 密码 确认 :{{ user.password2 }}</div> 
<button type="submit" class="btn btn-primary btn-block"> 注 册 
</button> 
</form> 
</div> 
</div> 
</div> 
</div> 
</body> 
</html> 


# views .py 的 视图 函数 registerView 
from django .shortcuts import render 
from .form import MyUserCreationForm 
# 使 用 表单 实现 用 户 注册 
def registerView (request): 
if request.method == 'POST': 
user = MyUserCreationForm(request .POST) 
if user.is valid(): 
user.save() 
tips = ' 注册 成 功 ' 
user = MyUserCreationForm() 
else: 
user = MyUserCreationForm() 
return render(request, 'user.html',locals()) 


从 上 述 代码 可 以 看 到 ， 视 图 函数 registerView 使 用 表单 类 MyUserCreationForm 实 
现 用 户 注册 功能 ， 功 能 说 明 如 下 : 


@ ” 当 用 户 在 浏览 器 上 访问 http://127.0.0.1:8000/user/registerhtml] 时 ， 视 图 函数 首 
先 将 表单 类 MyUserCreationForm 实例 化 后 传 给 模板 ， 在 网 页 上 生成 用 户 注册 
的 表单 界面 。 
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rd ast login is superuser 。 usemame ”fistname lastname email is staff isactive date joined 
2 sha;2018-03-2 1 root 554301 1 








e 输入 用 户 信 息 并 单 击 “ 注 册 ” 按 钮 ， 程序 将 表单 数据 交 给 表单 类 


MyUserCreationForm 处 理 并 生成 user 对 象 。 


最 后 验证 user 对 象 的 数据 格式 ， 若 验证 成 功 通过 ， 则 将 数据 保存 到 数据 表 
user myuser 中 ， 如 图 9-16 所 示 。 


| 
车 各 注 - 本 外 选 与 拓 让 区 SA 队 SL 





qq weChat mot| 
1 2018-03-20 124 


Quserl 1 2018-03-20 124 


1 2018-03-20 13:5 5543C123456 _134: 








9-16 数据 表 user_myuser 


9.4 设置 用 户 权限 





用 户 权限 主要 是 对 不 同 的 用 户 设置 不 同 的 功能 使 用 权限 ， 而 每 个 功能 主要 以 模 


型 来 划分 。 以 9.3 节 的 MyDjango 项 目 为 例 ， 在 Admin 后 台 管理 系统 可 以 查看 并 设置 
用 户 权 限 ， 如 图 9-17 所 示 。 


为 例 : 
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a li | 


haer | 产品 人 1 Can adq ProoucT 
inder | 产品 信息 | Can change product 
index | 产品 信息 | Can delete product 
index | 产品 类 型 | can add ype 
index | 产品 类 型 1 Can change ype 
inder | Pa | Can delete ype 
sessions | 会 汪 1Can add session 
sesaiona| 双 笑 | Can change seoaon 
sessions | 会 天 |Can delete session 
Miser| 用户 1Can aqd User 

user | BP | Can change user 
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图 9-17 用 户 权限 设置 

















9-17 左边 列表 框 中 列 出 了 整个 项 目的 用 户 权 限 ， 以 user | 用 户 | Can add user 








user 代表 项 目的 App。 
用 户 代 表 App 所 定义 的 模型 MyUser。 
Can add user 代表 该 权限 可 对 模型 MyUser 执行 新 增 操作 。 
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一 般 情况 下 ， 在 执行 数据 迁移 时 ， 每 个 模型 默认 拥有 增 add) ， 改 〈change) ， 
删 (delete) 权限 。 数 据 迁 移 完成 后 ， 可 以 在 数据 库 中 查看 数据 表 auth permission 的 
数据 信息 ， 每 条 数据 信息 代表 项 目 中 某 个 模型 的 某 个 权限 ， 如 图 9-18 所 示 。 








图 9-18 数据 表 auth_permission 的 数据 信息 





设置 用 户 权限 实质 上 是 对 数据 表 user_ myuser 和 auth _ permission 之 间 的 数据 设置 
多 对 多 关系 。 首 先 需 要 了 解 用 户 、 用 户 权 限 和 用 户 组 三 者 之 间 的 关系 ， 以 MyDjango 
的 数据 表 为 例 ， 如 图 9-19 所 示 。 




















国 auth_group 
auth_group_permissions 
国 auth_permission 

围 django_admin_log 
django_content type 

国 django_migrations 
django_session 

围 index_product 
国 index_ type 

围 User_myuser 
围 
围 

































































user_myuser_groups 
Huser_myuser_user_permissions 
































图 9-19 数据 库 结构 











从 整个 项 目的 数据 表 可 以 看 到 ， 用 户 、 用 户 权限 和 用 户 组 分 别 对 应 数据 表 user_ 
myuser、auth_permission 和 auth_ group。 无 论 是 设置 用 户 权 限 、 设 置 用 户 所 属 用 户 组 
还 是 设置 用 户 组 的 权限 , 其 实质 都 是 对 两 个 数据 表 之 间 的 数据 建立 多 对 多 的 数据 关系 ， 
说 明 如 下 : 
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e 数据 表 user myuser user permissions: 管理 数据 表 user myuser 和 auth 
permission 之 间 的 多 对 多 关系 ， 实 现 用 户 权限 设置 。 

@ 数据 表 user myuser groups: 管理 数据 表 user myuser 和 auth group 之 间 的 多 
对 多 关系 ， 实 现在 用 户 组 设置 用 户 。 

ee ”数据 表 auth group permissions: 管理 数据 表 auth group 和 auth permission 之 

间 的 多 对 多 关系 ， 实 现 用 户 组 设置 权限 。 














实现 用 户 的 权限 设置 需要 注意 : 如 果 用 户 角色 是 超级 用 户 ， 该 用 户 是 无 须 设置 权 
限 的 ， 用 户 权 限 只 适用 于 非 超级 用 户 。 我 们 在 PyCharm 的 Terminal 下 开启 Django 的 
shell 模式 来 实现 用 户 权限 设置 ， 代 码 如 下 : 






























































E:\MyDjango>python manage.py shell 

# 导入 模型 MyUser 

>>> from user.models import MyUser 

# 查询 用 户 信息 ，filter 查询 返回 列表 格式 ， 因 此 设置 列表 索引 获取 User 对 象 

>>> user = MYUser.objects .filter (username='userl') [0] 

# 判断 当前 用 户 是 否 具有 权限 add_product 

# index.add product 为 固定 写法 ，index 为 项 目的 App 名 ， add product 是 数据 表 auth_ 
permission 的 字段 codename 

>>> user.has perm('index.add product') 

False 

# 导入 模型 Permission 

>>> from django.contrib.auth.models import Permission 

# 在 权限 管理 表 获 取 权限 add_product 的 数据 对 象 permission 

>>> permission = Permission.objects.filter (codename='add product') [0] 

# 对 当前 用 户 对 象 user 设置 权限 add_product 

>>> user.user permissions.add (Permission) 

# 再 次 判断 当前 用 户 是 否 具有 权限 add_product 

>>> user.has perm('index.add product') 

True 


上 述 代 码 对 用 户 名 为 userl 的 用 户 设置 了 产品 信息 的 新 增 权限 ， 打 开 数 据 表 user_ 
myuser_user_permissions 可 以 看 到 新 增 了 一 条 数据 ， 如 图 9-20 所 示 。 
































文 久生 直 看 定 D 的 
好 Fe 事务 国 各 注 " 村 二 搓 扒 记 区 SA 加 SL 
myuserid permissionid 


wi1+ 小 必 加 日 
血 1 条 记录 内 1 妈 于 第 1 页 





9-20 数据 表 User_myuser user_permissions 
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数据 表 的 字段 myuser id 和 permission id 分别 是 数据 表 user myuser 和 auth 
permission 的 主键 ， 图 9-20 上 的 每 一 条 数据 代表 某 个 用 户 具 有 某 个 模型 的 某 个 操作 权 
限 。 除 了 添加 权限 之 外 ， 还 可 以 对 用 户 的 权限 进行 删除 和 查询 ， 代 码 如 下 : 


>>> user = MyUser.objects.filter (username='userl') [0] 

>>> Permission = Permission.objects.filter (codename='"add product') [0] 

# 删除 某 条 权限 

>>> user.user permissions .remove (Permission) 

# 判断 是 否 已 删除 权限 ， 若 为 false， 说 明 删 除 成 功 。 函 数 has_perm 用 于 判断 用 户 是 否 拥有 权限 

>>> user.has perm('index.add product') 

False 

# 清空 当前 用 户 全 部 权限 

>>> user.user permissions.clear() 

# 获取 当前 用 户 所 拥有 的 权限 信息 

# 将 上 述 删除 的 权限 添加 到 数据 表 再 查询 

>>> user.user permissions.add (Permission) 

>>> user.user permissions.values() 

<QuerySet [{'content type id': 6, 'codename': 'add product', 'name': 'Can 
add product', 'id': 16}]> 


9.5 自 定义 用 户 权限 


一 般 情况 下 ， 每 个 模型 默认 拥有 增 (add) ， 改 (change) ， 删 (delete》 权 限 。 
但 实际 开发 中 ， 可 能 要 对 某 个 模型 设置 特殊 的 权限 ， 比 如 设置 访问 权限 。 为 了 解决 这 
种 情况 , 在 定义 模型 的 时 候 , 可 以 在 模型 的 Meta 中 设置 自 定义 权 限 。 以 MyDjango 为 例 ， 
对 index 的 模型 Product 重新 定义 ， 代 码 如 下 : 


class Product (models.Model): 
id = models.AutoField(' 序号 '， primary_ key=True) 
name = models.CharField(' 名 称 ',max length=50) 
weight = models.CharField(' 重量 ' max_ length=20) 
size = models.CharField(' 尺寸 ',max_length=20) 
type = models.ForeignKey (Type, on_ delete=models.CASCADE,verbose_ 
name=' 产品 类 型 ') 

# 设置 返回 值 
def _str {self): 

return self.name 
class Meta: 

# 自 定义 权限 

permissions = ( 

('visit Product', "Can visit Product'), 


) 
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定义 模型 Product 的 时 候 ， 通 过 重 写 父 类 models.Model 的 permissions 属性 可 
实现 自 定义 用 户 权 限 。 该 属性 以 元 组 或 列表 的 数据 格式 表示 ， 每 个 元 素 代表 一 个 权 
限 ， 也 是 以 元 组 或 列表 表示 。 在 一 个 权限 中 含有 两 个 元 素 ， 如 ('add_Product', 'Can 
create Product')，add_Product 和 Can create Product 分 别 是 数据 表 auth permission 的 
codename 和 name 字段 。 

在 数据 库 中 清除 MyDiango 原 有 的 数据 表 ， 并 在 PyCharm 的 Terminal 中 重新 执 
行 数据 迁移 ， 指 令 代码 如 下 : 























E:\MyDjango>python manage.py makemigrations 
Migrations for '‘'index': 
index\migrations\0001 initial.py 
— Create model Product 
— Create model Type 
- Add field type to product 
E:\MyDjango>python manage.py migrate 


指令 执行 完成 后 ， 在 数据 库 中 打开 数据 表 auth_ permission， 可 以 找到 自 定义 权限 
visit_ Product， 如 图 9-21 所 示 。 


文人 坊 镶 查看 定 口 。 部 肋 
a 因 备 主 -下 入 和 且 # 序 革 SA 芭 4 
id name ‘contenttypeid codename 
» ETIT Gauiete ype 
19 Can add product 7 add_product 
20 Can change product 7 change_product 
21 Can delete product 7 delete_product 
[ convisitproddt 7 vtpProdudt 
23 Can add user 8 add_myuser 
24 Can change user 8 change myuser 
8 delote_myusor 


ee ww 1# 吉 立 国 丫 
第 18 条 记录 ( 共 25 条) 于 第 1 页 





图 9-21 自 定义 权限 visit_Product 


9.6 设置 网 页 的 访问 权限 





通过 前 面 的 学 习 , 相信 大 家 对 Django 的 内 置 权限 功能 有 一 定 的 了 解 。 在 本 节 中 ， 
我 们 会 结合 实际 的 例子 讲述 如 何在 实际 开发 中 使 用 用 户 权限 ， 以 MyDjango 为 例 ， 数 
据 表 auth permission 已 自 定义 权限 visit Product， 数 据 表 user myuser 分 别 创建 了 一 
名 超级 用 户 和 一 名 普通 用 户 ， 如 图 9-22 所 示 。 
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id password lastlogn jissuperuser username firstname lastname email is staf is active datejoined qq weChat 
， 国 国 pekdt sh2018-03-22 1 1 2018.03-.22( 


2 pbkdf2_she 0 1 2018.03231 


mw1ivwe 回 日 
秽 1 这 记 民 条 | 于 秽 1 页 


图 9-22 数据 表 user_ myuser 的 用 户 信息 





本 例 需要 将 项 目的 index 和 user 结合 使 用 。index 主要 将 权限 应 用 到 开发 中 ， 而 
user 主要 用 于 用 户 的 注册 、 登 录 和 退出 登录 ， 用 于 检验 index 的 应 用 效果 。 

首先 讲解 user 的 开发 流程 ， 我 们 分 别 对 路 由 urlspy、 视 图 viewspy 和 模板 user. 
html 进行 相应 开发 ， 共 同 完成 用 户 的 注册 、 登 录 和 退出 登录 ， 代 码 如 下 : 















































# 路 由 urls.py 

from django.urls import path 

from . import views 

urlpatterns = [ 

# 用 户 登 录 

path('login.html', views.loginView, name='login’'), 

# 用 户 注册 

path('register.html', views.registerView, name='register'), 
# 退出 登录 

path('logout.html', views.logoutView, name='logout'), 


] 


# 视图 views .py 

from django.shortcuts import render, redirect 

from .models import MyUser 

from django.contrib.auth.models import Permission 

from django.contrib.auth import login, authenticate, logout 


# 用 户 登 录 
def loginView (request): 
tips = ' 请 登录 ' 
title = ' 用 户 登录 ' 
if request.method == 'POST': 
username = request.POST.get ('username', "'') 


password = request.POST.get ('password', "'') 
if MyUser.objects.filter (username=username): 
user = authenticate (username=username, password=password) 
if user: 
if user.is active: 
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# 登录 当前 用 户 
login(request, user) 
return redirect('/') 
else: 
tips =' 账号 密码 错误 ， 请 重新 输入 ' 
else: 
tips = ' 用 户 不 存在 ， 请 注册 ' 


return render(request, ‘user.html', locals()) 


# 用 户 注册 
def registerView (request) : 
title = ' 用 户 注册 ' 
if request.method == 'POST': 
username = request.POST.get ('username', '') 
password = request.POST.get ('password', '') 
if MyUser.objects .filter (username=username): 
tips = ' 用 户 已 存在 ' 
else: 
user = MyUser.objects.create user (username=usernamey 
password=password) 
user.save() 
# 添加 权限 
permission = Permission.objects .filter (codename='visit_ 
Product') [0] 
user.user permissions.add (permission) 
return redirect('/user/login.html') 
return render(request, 'user.html', locals()) 


# 退出 登录 

def logoutView (request): 
logout (request) 
return redirect('/') 


# 模板 user.html 

<!DOCTYPE html> 

<html lang="zh-cn"> 

<head> 
<meta charset="utf-8"> 
<title>{{ title }}</title> 
<link rel="stylesheet" href="https://unpkg.com/mobi.css/dist/mobi. 

min.css"> 

</head> 

<body> 

<div class="flex-center"> 
<div class="container"> 
<div class="flex-center"> 





<div class="unit-1-2 unit-1-on-mobile"> 


154 


第 9 章 Auth 认证 系统 


<hl>MyDjango Auth</h1> 
{% if tips %} 
<div>{{ tips }}</div> 
{g% endif %} 
<form class="form" action="" method="post"> 
{$$ csrf token %} 
<div> 用 户 名 :<input type="text" name='username'></div> 
<div> 密 码 :<input type="password" name='password'></div> 
<button type="submit" class="btn btn-primary btn-block"> 确定 
</button> 
</form> 
</div> 
</div> 
</div> 
</div> 
</body> 
</html> 


上 述 代 码 主 要 实现 一 个 简单 的 操作 流程 ， 流 程 顺 序 为 用 户 注册 一 用 户 登录 一 访 
问 首页 ， 具 体 实现 过 程 如 下 : 


e@ 首先 用 户 访问 用 户 注 册 界面 ， 输 入 新 的 用 户 信 息 并 单 击 “ 确 定 ” 按 钮 ， 提交 
用 户 注 册 信息 到 网 站 后 台 。 

e@ 后 台 的 视图 函数 registerView 接收 表单 数据 ， 判 断 当 前 注册 的 用 户 是 否 存在 。 
如 果 用 户 不 存在 ， 将 表单 数据 保存 到 数据 表 user_myuser 中 ， 创 建新 的 用 户 信 
息 。 

e@ 默认 情况 下 ， 新 创建 的 用 户 是 没有 设置 任何 权限 的 ， 视 图 函数 对 新 创建 的 用 
户 设置 visit_Product 权限 。 注 册 成 功 后 ， 程 序 会 自动 跳 转 到 用 户 登 录 界 面 。 

e 在 用 户 登 录 界 面 输入 新 创建 的 用 户 信 息 ， 完 成 用 户 登 录 后 ， 程 序 会 自动 跳 转 
到 网 站 的 首页 。 


在 user 中 实现 了 用 户 的 权限 设置 ， 为 新 创建 的 用 户 添加 visit_Product 权限 ， 接 
着 在 index 中 实现 用 户 权 限 的 校 验 。 在 index 的 路 由 urlspy、 视 图 views.py 和 模板 
index.html 中 分 别 编写 以 下 代码 : 

# 路 由 urls.py 

from django.urls import path 

from . import views 


urlpatterns = [ 


# 首页 的 URL 
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path('', views.index), 


] 


# 视图 views .py 

from django .shortcuts import render 

from django.contrib.auth.decorators import login required, permission 
required 

# 使 用 login required 和 permission required 分 别 对 用 户 登录 验证 和 用 户 权 限 验 证 

@login required(login url='/user/login.html') 

@permission required(perm="'index.visit Product', login url=" /user/login. 
html') 

def index(request): 

return render(request, ‘'index.html', locals()) 


在 视图 函数 index 中 使 用 了 装饰 器 login_required 和 permission_required， 分 别 对 
当前 用 户 的 登录 状态 和 用 户 权 限 进行 校 验 ， 说 明 如 下 。 
login_required: 设置 用 户 登录 访问 权限 。 如 果 当 前 用 户 尚 未 在 用 户 登 录 界 面 完成 


登录 而 直接 访问 首页 , 程序 自动 跳 转 到 登录 界面 ,只 有 用 户 完成 登录 后 才能 访问 首页 。 
login_required 的 参数 有 redirect_field name 和 login_url。 


e 参数 redirect field name: 默认 值 是 next。 当 登录 成 功 之 后 ， 程 序 会 自动 跳 回 
之 前 浏览 的 网 页 。 

。 参数 login url: 设置 登录 界面 的 URL 地 址 。 默 认 值 是 settings.py 的 属性 
LOGIN_URL, 而 属性 LOGIN_URL 需要 开发 者 自行 在 settings.py 中 配置 。 


permission_required: 验证 当前 用 户 是 否 拥 有 相应 的 权限 。 若 用 户 没 有 使 用 权限 ， 
程序 会 跳 转 到 登录 界面 或 者 抛 出 异常 。permission_required 的 参数 如 下 。 


。 参数 perm: 必需 参数 ， 判 断 当 前 用 户 是 否 拥 有 权限 。 参 数值 为 固定 格式 ， 
如 index.visit Product，index 为 项 目的 App 名 ，visit product 来 自 数据 表 
auth_permission 的 字段 codename。 

ee 参数 login url: 设置 登录 界面 的 URL 地 址 ， 默 认 值 为 None。 若 不 设置 参数 ， 
验证 失败 后 会 抛 出 404 异常 。 

@ 参数 raise exception: 设置 抛 出 异常 ， 默 认 值 为 False。 


装饰 器 permission required 的 作用 与 内 置 函 数 has_perm 相同 ， 上 述 代码 也 可 以 使 
用 函数 has_perm 实现 装饰 器 permission required 的 功能 ， 代 码 如 下 : 
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# 使 用 函数 has_perm 实现 装饰 器 permission required 功能 
from django .shortcuts import render, redirect 
elogin required(login url='/user/login.html') 
def index(request): 
user = request.user 
if user.has perm('index.visit Product'): 
return render(request, 'index.html', locals()) 
else: 
return redirect('/user/login.html') 


最 后 在 模板 index.html 中 实现 用 户 权限 判断 ， 这 也 是 权限 校 验 的 使 用 方法 之 一 。 
模板 index.html 的 <header> 标签 代码 修改 如 下 : 


<header id="top"> 
<!-- 内 容 显示 区 域 : width : 1211px --> 
<div id="top box"> 
<ul class="lf"> 
<1i><a href="#"> 华为 官网 </a></1i> 
<1i><a href="#"> 华为 荣耀 </a></1i> 
</ul> 
<ul class="rt"> 
{# 在 模板 中 使 用 user 变量 是 一 个 User 或 者 AnoymousUser 对 象 ， 该 对 象 由 模型 MyUser 实 
例 化 #} 
{% if user.is authenticated %} 
<1i> 用 户 名 : {{ user.username }}</1i> 
<li><a href="{% url 'logout' %}"> 退出 登录 </a></1i> 
{% endif %} 
{# 在 模板 中 使 用 perms 变量 是 Permi ssion 对 象 ， 该 对 象 由 模型 Permission 实例 化 #} 
{% if perms.index.add product %} 
<1i> 添加 产品 信息 </1i> 
{% endif %} 
</ul> 
</div> 
</header> 


在 模板 index.html 中 分 别 使 用 变量 user 和 perms， 但 从 视图 函数 index 中 可 以 发 
现 ， 视 图 函数 并 没有 将 变量 user 和 perms 传递 给 模板 。 其 实 变 量 user 和 perms 是 由 
Django 自动 生成 的 ， 变 量 的 生成 与 配置 文件 settings.py 的 TEMPLATES 设置 有 关 ， 我 
们 查看 settings.py 的 TEMPLATES 配置 信息 ， 代 码 如 下 : 
TEMPLATES = [ 
{ 
'BACKEND': "django.template.backends.django.DjangoTemplates', 


'DIRS': [os.path.join(BASE DIR, ' index/templates'), 
os.path.join(BASE DIR, 'user/templates'),], 
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] 


'APP DIRS': True, 


'OPTIONS': { 
'context processors': [ 


‘django.template.context processors.debug', 


'django.template.context processors.request', 


'django.contrib.auth.context processors.auth', 


'django.contrib.messages.context processors.messages', 


因为 TEMPLATES 中 定义 了 处 理 器 集合 context processors， 所 以 在 解析 模板 
Template 之 前 ，Django 首先 依次 运行 处 理 器 集合 的 程序 。 当 运行 到 处 理 器 django. 
contrib.auth.context processors.auth 时 ， 程 序 会 生成 变量 user 和 perms， 并 且 将 变量 传 
入 模板 变量 TemplateContext 中 ， 所 以 在 模板 中 可 以 直接 使 用 变量 user 和 perms。 

从 上 述 例子 可 以 看 到 ， 项 目的 user 主要 实现 权限 的 设置 功能 ， 项 目的 index 主要 
实现 权限 的 使 用 ， 权 限 的 使 用 主要 判断 当前 用 户 是 否 具有 权限 的 使 用 资格 ， 而 权限 的 
判断 可 以 从 视图 函数 或 模板 语法 实现 。 在 浏览 器 上 分 别 使 用 超级 用 户 和 普通 用 户 登录 





我 的 购物 车 


网 站 ， 两 者 的 首页 信息 如 图 9-23 所 示 。 


用 户 各 : userl 。 退出 登录 ~ 用 户 各 : root 。 退 册 登录 。 添加 产品 信息 









































mm 人 |: 中信 | : 


我 的 商城 我 的 购物 车 








图 9-23 左 图 是 普通 用 户 登录 后 的 首页 信息 ， 右 图 是 超级 用 户 登 录 后 的 首页 信息 


9.7 设置 用 户 组 






























































顾名思义 ， 用 户 组 就 是 对 用 户 进行 分 组 管理 ， 其 作用 是 在 权限 控制 中 可 以 批量 
地 对 用 户 的 权限 进行 分 配 ， 而 不 用 一 个 一 个 地 按 用 户 分 配 ， 节 省 维护 的 工作 量 。 将 
个 用 户 加 入 一 个 用 户 组 ， 该 用 户 就 拥有 该 用 户 组 所 分 配 的 所 有 权限 。 例 如 用 户 组 


















































teachers 拥有 权限 can_create lesson， 那 么 所 有 属于 teachers 的 用 户 都 会 有 can_create_ 
lesson 权限 。 
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用 户 组 可 以 理 



































我 们 知道 用 户 、 权 限 和 用 户 组 三 者 之 间 是 多 对 多 的 数据 关系 ， 而 
解 为 用 户 和 权限 之 间 的 中 转 站 。 设 置 用 户 组 分 为 两 个 步骤 : 设置 用 户 组 的 权限 和 设置 
用 户 组 的 用 户 。 
设置 用 户 组 的 权限 主要 对 数据 表 auth_group 和 auth permission 构建 多 对 多 的 数 
据 关 系 ， 数 据 关 系 保存 在 数据 表 auth_group_permissions 中 。 以 MyDjango 为 例 ， 其 
数据 库 结构 如 图 9-24 所 示 。 
国 auth_group 
auth_group_permissions 
auth_permission 











国 django admin log 
django_content type 
国 django_migrations 
django_session 

国 index_product 

围 index type 

围 wser_myuser 
围 wser_myuser groups 
user_myuser_user_permissions 















































图 9-24 数据 库 结构 











在 数据 表 auth_group 中 创建 三 条 数据 信息 : 产品 信息 、 产 品类 型 和 用 户 管理 ， 


每 条 信息 在 项 目 中 代表 一 个 用 户 组 ， 如 图 9-25 所 示 。 


我 们 在 PyCharm 的 Terminal 中 使 用 Dijango 的 shell 模式 来 实现 上 


代码 如 下 : 


国 备注 " 可 区 迁 县 排 计 臣 SA 苇 S94 





9-25 数据 表 auth_group 








# 用 户 组 的 权限 配置 
# 导入 内 置 模型 Group 和 Permission 


>>> from django.contrib.auth.models import Group 








和 户 组 的 权限 配置 ， 
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>>> from django.contrib.auth.models import Permission 

# 获取 某 个 权限 对 象 permission 

>>> permission = Permission.objects.get (codename='visit Product') 
# 获取 某 个 用 户 组 对 象 group 

>>> group = Group.objects.get (id=1) 

# 将 权限 permission 添加 到 用 户 组 group 中 


>>> group.permissions.add (permission) 
上 述 代码 将 visit_Product 权限 添加 到 用 户 组 (产品 信息 ) ， 功 能 实现 过 程 如 下 : 


e 从 数据 表 auth_ group 获取 用 户 组 (产品 信息 ) 对 象 group， 对 象 group 代表 数 
据 表 中 某 一 条 数据 。 

ee 从 数据 表 auth _ permission 获取 权限 (visit Product) 对 象 permission， 对 象 
permission 代表 数据 表 中 某 一 条 数据 。 

日 ”使 用 permissions.add 方法 将 权限 对 象 permission 与 用 户 组 对 象 group 构建 多 
对 多 数据 关系 并 保存 在 数据 表 auth_group_permissions 中 。 查 看 数据 表 auth_ 
group_permissions， 数 据 信 息 如 图 9-26 所 示 。 


文件 纺 和 ”让 看 窜 口 。 帮助 

和 S 到 事务 ” 国 备 主 -本 入 迁 后 排 朱 臣 SA 国 Sd 
id groupid 。 permission id 

» 1 22 


mw 19 六 加 四 
第 1 条 记录 ( 共 1 条 ) 于 第 1 页 





图 9-26 数据 表 auth_group_permissions 























除了 添加 用 户 组 的 权限 之 外 ， 还 可 以 删除 用 户 组 已 有 的 权限 ， 代 码 如 下 : 











# 删除 当前 用 户 组 group 的 visit_Product 权限 
>>> group.permissions.remove (permission) 
# 删除 当前 用 户 组 group 的 全 部 权限 


>>> group.permissions.clear() 




















设置 用 户 组 的 用 户主 要 对 数据 表 auth_group 和 user myuser 构建 多 对 多 数据 关系 ， 
数据 关系 保存 在 数据 表 user_myuser_groups 中 。 在 Django 的 shell 模式 下 实现 用 户 组 
的 用 户 设置 ， 代 码 如 下 : 


























# 将 用 户 分 配 到 用 户 组 
# 导入 模型 Group 和 MyUser 
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>>> from user.models import MyUser 


>>> from django.contrib.auth.models import Group 

# 获取 用 户 对 象 user， 对 象 user 代表 用 户 名 为 userl 的 数据 信息 
>>> user = MYUser.obJjects .get (username='userl') 

# 获取 用 户 组 对 象 group， 对 象 group 代表 用 户 组 《产品 信息 ) 的 数据 信息 
>>> group = Group.objects.get (id=1) 
# 将 用 户 添加 到 用 户 组 


>>> user.groups.add (group) 


上 述 代 码 将 用 户 名 为 userl 的 上 




















户 添加 到 用 户 组 (产品 信息 ) ， 功 能 实现 过 程 与 


用 户 组 的 权限 设置 是 相似 的 ， 只 不 过 两 者 所 使 用 的 模型 有 所 不 同 。 查 看 数据 表 user_ 
Imyuser_groups， 数 据 信 息 如 图 9-27 所 示 。 


文件 编 局 查看 闸口 帮助 
好 Hi 事 务 。 国 备注 " 可 下 县 排 计 苇 SA 臣 员 


id 


myuserid groupjid 
2 1 


ww1+ 收 尺 | 国 加 
第 1 条 记录 ( 共 1 条) 于 第 1 页 





9-27 数据 表 user_myuser_groups 




















除了 添加 用 户 组 的 用 户 之 外 ， 还 可 以 删除 用 户 组 已 有 的 用 户 ， 代 码 如 下 : 











# 删除 用 户 组 某 一 用 户 
>>> user.groups .emove (group) 
# 清空 用 户 组 全 部 用 户 


>>> User.groups.clear() 








9.8 本 章 小 结 














Django 除了 有 强大 的 Admin 管理 系统 之 外 ， 还 提供 了 完善 的 用 户 管理 系统 。 整 
个 用 户 管理 系统 可 分 为 三 大 部 分 : 用 户 信息 、 用 户 权限 和 用 户 组， 在 数据 库 中 分 别 对 
应 数据 表 auth_user、auth_permission 和 auth_group。 


使 用 内 置 模型 User 和 内 置 的 函数 可 以 快速 实现 用 户 管理 功能 , 如 用 户 注册 、 登 录 、 

















密码 修改 、 密 码 找 








9 






































和 用 户 注销 。 模 型 User 的 字段 说 明 以 及 常 上 

















的 内 置 函 数 如 下 。 
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模型 User 字 段 及 说 明 
模型 User 字 段 说 明 
1d int 类 型 ， 数 据 表 主 键 
esi varchar 类 型 ， 代 表 用 户 密码 ， 在 默认 情况 下 使 用 pbkdf2_sha256 方 式 
来 存储 和 管理 用 户 的 密码 
last_login datetime 类 型 ， 最 近 一 次 登录 的 时 间 





1s_superuser 


tinyint 类 型 ， 表 示 该 用 户 是 否 拥有 所 有 的 权限 ， 即 是 否 为 超级 用 户 


























Username varchar 类 型 ， 代 表 用 户 账号 
first name varchar 类 型 ， 代 表 用 户 的 名 字 
last_name varchar 类 型 ， 代 表 用 户 的 姓氏 
Email varchar 类 型 ， 代 表 用 户 的 邮件 
is_staff 用 来 判断 用 户 是 否 可 以 登录 进入 Admin 系 统 
is_active tinyint 类 型 ， 用 来 判断 该 用 户 的 状态 是 否 被 激活 
date joined datetime 类 型 ， 账 号 的 创建 时 间 
常用 的 内 置 函数 及 说 明 
内 置 函数 说 明 


authenticate 


create_user 


验证 用 户 是 否 存在 ， 必 选 参数 为 username 和 password， 只 能 用 于 
模型 User 


创建 新 的 用 户 信息 ， 必 选 参数 为 username， 只 能 用 于 模型 User 














set_password 修改 用 户 密码 ， 必 选 参数 为 password， 只 能 用 于 模型 User 

login/ logout 用 户 的 登录 和 注销 ， 只 能 用 于 模型 User 

make_password 密码 加 密 处 理 ， 必 选 参数 为 password， 可 脱离 模型 User 单 独 使 用 
check password 检验 加 密 前 后 的 密码 是 否 相 同 ， 可 脱离 模型 User 单 独 使 用 

email user 发 送 邮件 ， 只 能 用 于 模型 User 

send_mail 发 送 邮 件 

send_mass_mail 批量 发 送 邮 件 

EmailMultiAlternatives 发 送 自 定义 内 容 格式 的 邮件 





Django 提供 了 4 种 模型 扩展 的 方法 。 


日 ”代理 模型 ;这 是 一 种 模型 继承 ， 这 种 模型 在 数据 库 中 无 须 创建 新 数据 表 。 一 
般 用 于 改变 现 有 模型 的 行为 方式 ， 如 增加 新 方法 函数 等 ， 并 且 不 影响 现 有 数 


据 库 的 结构 。 


当 不 需要 在 数据 库 中 存储 额外 的 信息 ， 而 需要 增加 操作 方法 或 


更 改 模型 的 查询 管理 方式 时 ， 适 合 使 用 代理 模型 来 扩展 现 有 User 模型 。 
@ Profile 扩展 模型 User: 当 存 储 的 信息 与 模型 User 相关 ， 而 且 并 不 改变 模 
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型 User 原 有 的 认证 方法 时 ， 可 定义 新 的 模型 MyUser， 并 设置 某 个 字段 为 

OneToOneField， 这 样 能 与 模型 User 形成 一 对 一 关联 ， 该 方法 称 为 用 户 配置 
(User Profile) 。 

AbstractBaseUser 扩展 模型 User: 当 模型 User 的 内 置 方法 并 不 符合 开发 需求 

时 ， 可 使 用 该 方法 对 模型 User 重新 自 定义 设计 ， 该 方法 对 模型 User 和 数据 

库 架 构 影响 很 大 。 

AbstractUser 扩展 模型 User: 如 果 模 型 User 的 内 置 的 方法 符合 开发 需求 ， 

在 不 改变 这 些 函 数 方法 的 情况 下 ， 添 加 模型 User 的 额外 字段 ， 可 通过 

AbstractUser 方式 实现 。 使 用 AbstractUser 定义 的 模型 会 替换 原 有 模型 User。 


用 户 、 用 户 权限 和 用 户 组 分 别 对 应 数据 表 user_ myuser、auth_ permission 和 auth_ 
group。 无 论 是 设置 用 户 权限 、 设 置 用户 所 属 用 户 组 还 是 设置 用 户 组 的 权限 ， 其 实质 
都 是 对 两 个 数据 表 之 间 的 数据 建立 多 对 多 的 数据 关系 ， 说 明 如 下 : 


数据 表 user myuser user permissions: 管理 数据 表 user myuser 和 auth_ 
permission 之 间 的 多 对 多 关系 ， 实 现 用户 权 限 设置 。 

数据 表 user myuser_groups: 管理 数据 表 user myuser 和 auth group 之 间 的 多 
对 多 关系 ， 实 现在 用 户 组 设置 用 户 。 

数据 表 auth_group_permissions: 管理 数据 表 auth_group 和 auth permission 之 
间 的 多 对 多 关系 ， 实 现 用 户 组 设置 权限 。 
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Django 为 开发 者 提供 了 常见 的 Web 应 用 程序 , 如 会 话 控制 、 高 速 缓存 .CSRF 防护 、 
消息 提示 和 分 页 功能 。 内 置 的 Web 应 用 程序 大 大 优化 了 网 站 性 能 ， 并 且 完 善 了 安全 
防护 机 制 ， 而 且 也 提高 了 开发 者 的 开发 效率 。 


10.1 会 话 控 制 


Django 内 置 的 会 话 控制 简称 为 Session， 可 为 访问 者 提供 基础 的 数据 存储 。 数 据 
主要 存储 在 服务 器 上 ， 并 且 网 站 的 任意 站 点 都 能 使 用 会 话 数据 。 当 用 户 第 一 次 访问 网 
站 时 ， 网 站 的 服务 器 将 自动 创建 一 个 Session 对 象 ， 该 Session 对 象 相 当 于 该 用 户 在 
网 站 的 一 个 身份 凭证 ， 而 且 Session 能 存储 该 用 户 的 数据 信息 。 当 用 户 在 网 站 的 页 面 
之 间 跳 转 时 ， 存 储 在 Session 对 象 中 的 数据 不 会 丢失 ， 只 有 Session 过 期 或 被 清理 时 ， 
服务 器 才 将 Session 中 存储 的 数据 清空 并 终止 该 Session。 
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解 Django 的 Session 之 前 ， 需 要 理解 Session 和 Cookie 之 间 的 关系 。 

@ Session 是 存储 在 服务 器 端 ，Cookie 是 存储 在 客户 端 ， 所 以 Session 的 安全 性 
比 Cookie 高 。 

e ” 当 获 取 Session 的 数据 信息 时 ， 首 先 从 会 话 Cookie 里 获取 sessionid， 然 后 根据 
sessionid 找到 服务 器 相应 的 Session。 

e ”Session 是 存放 在 服务 器 的 内 存 中 的 ， 所 以 Session 里 的 数据 不 断 增 加 会 造成 服 


务 器 的 负担 。 因 此 ， 重 要 的 信息 才 会 选择 存放 在 Session 中 ， 而 一 些 次 要 的 信 
息 选择 存放 在 客户 端的 Cookie。 


在 创建 Django 项 目 时 ，Django 已 默认 启用 Session 功能 ，Session 是 通过 Django 
的 中 间 件 实现 的 ， 可 以 在 配置 文件 settings.py 中 找到 相关 信息 ， 如 图 10-1 所 示 。 





MIDDLEWARE = [ 





ango. niddleware. locale. LocaleMiddleware’ , 

"django. middleware. common. CommonMiddleware”, 

"django. middleware. csrf. CsrfViewliddleware’, 

"django. contrib. auth. middleware. AuthenticationMiddleware’, 
"django. contrib. nessages. niddleware. MessageMiddleware’ , 
"django. niddleware. clickjacking.Xpraae0ptionsMiddleware'， 








图 10-1 Session 功能 配置 

















当 用 户 访问 网 站 时 ， 用 户 请 求 首先 经 过 中 间 件 的 处 理 ， 而 中 间 件 
SessionMiddleware 会 判断 当前 请 求 用 户 的 身份 是 否 存在 ， 并 根据 判断 情况 执行 相应 的 
程序 处 理 。 中 间 件 SessionMiddleware 相当 于 用 户 请 求 接收 器 ， 根 据 请 求 信 息 做 出 相 
应 的 调度 ， 而 程序 的 执行 是 由 配置 文件 settings.py 中 的 INSTALLED_APPS 完成 的 。 
而 执行 Session 的 处 理由 django.contrib.sessions 完成 ， 其 配置 信息 如 图 10-2 所 示 。 




















INSTALLED_APPS =【 
"django. contrib. adain' ， 
"django. contrib. auth’ , 


"django. contrib. contentt7pes” ， 
django. contrib. m' ‘ges ， 
"django. contrib. staticfiles’, 
"index’, 






"user” » 




















图 10-2 Session 功能 处 理 
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django.contrib.sessions 默认 使 用 数据 库存 储 Session 信息 ， 发 生 数据 迁移 时 ， 在 数 
据 库 中 可 以 看 到 数据 表 django_session， 如 图 10-3 所 示 。 


国 auth group 
围 auth_group_permissions 
国 auth_permission 

国 django_admin_log 

围 django_content type 























围 wser_myuser groups 
围 user_myuser_user_permissions 











图 10-3 数据 表 django_session 

















当 多 个 用 户 同时 访问 网 站 时 ， 中 间 件 SessionMiddleware 分 别 获 取 客 户 端 Cookie 
的 sessionid 和 数据 表 django_session 的 session_key 进行 匹配 验证 ， 从 而 区 分 每 个 用 户 
的 身份 信息 ， 保 证 每 个 用 户 存放 在 Session 的 数据 信息 不 会 发 生 絮 乱 ， 如 图 10-4 所 示 。 
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ee 
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图 10-4 Session 验证 机 制 


从 上 述 内 容 可 以 知道 ，Session 默认 使 用 数据 库 保存 相关 的 数据 信息 ， 如 果 想 变 
更 Session 的 保存 方式 ， 我 们 可 以 在 settings.py 中 添加 配置 信息 SESSION_ENGINE， 
该 配置 可 以 指定 Session 的 保存 方式 。Django 提供 5 种 Session 的 保存 方式 ， 如 下 所 示 : 
# 数据 库 保存 方式 ，Django 默认 的 保存 方式 ， 因 此 使 用 该 方法 无 须 在 settings .py 中 设置 


SESSION ENGINE = ‘django.contrib.sessions.backends.db' 


# 以 文件 形式 保存 


SESSION ENGINE = ‘django.contrib.sessions.backends .file' 


# 使 用 文本 保存 可 设置 文件 保存 路 径 ，/MyDjango 代表 将 文本 保存 在 项 目 MyDjango 的 根 目录 
SESSION_FILE PATH = '/MyDjango' 
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# 以 缓存 形式 保存 

SESSION ENGINE = "django-contrib.sessions.-backendqds .cache'" 
# 设置 缓存 名 ， 默 认 是 内 存 缓存 方式 ， 此 处 的 设置 与 缓存 机 制 的 设置 相关 
SESSION CACHE ALIAS = "default'" 


# 以 数据 库 + 缓存 形式 保存 


SESSION ENGINE = '‘'django.contrib.sessions.backends.cached db' 


# 以 cookies 形式 保存 

SESSION ENGINE = 'django.contrib.sessions.backends.signed cookies' 

SESSION_ENGINE 用 于 配置 服务 器 Session 的 保存 方式 ， 如 果 想 要 配置 Cookie 
的 Session 的 保存 方式 ， 可 以 在 settings.py 中 添加 如 表 10-1 所 示 的 配置 。 


表 10-1 settings.py 需 要 添加 的 配置 


说 明 


SESSION COOKIE NAME = "sessionid" 设置 Cookie 里 Session 的 键 ， 默 认 值 为 sessionid 


是 否 使 用 HTTPS 传 输 CoKie， 炭 认 值 为 False 
是 否 只 支持 HTTP 传 输 ， 默 认 值 为 True 
设置 Cookie 里 Session 的 有 效 期 ， 默 认 时 间 2 周 


SESSION_EXPIRE_AT_BROWSER_ | 是 否 关闭 浏览 器 使 得 Session 过 期 ， 默 认 值 为 
CLOSE = False False 
是 否 每 次 发 送 后 保存 Session， 默 认 值 为 False 


了 解 Session 的 原理 和 相关 配置 后 ， 最 后 讲解 Session 的 操作 。Session 的 数据 类 
型 可 理解 为 Python 的 字典 类 型 ， 主 要 在 视图 函数 中 执行 读 写 操作 ， 并 且 从 用 户 请 求 
对 象 中 获取 ， 即 来 自视 图 函数 的 参数 request。Session 的 读 写 如 下 : 








# request 为 视图 函数 的 参数 request 
# 获取 k1 的 值 ， 若 k1 不 存在 则 会 报错 


request -session['kl'] 


# 获取 k1 的 值 ， 若 kl 不 存在 则 为 空 值 

# get 和 setdefault 所 实现 的 功能 是 一 臻 
request.session.get['ki', ''] 
request .session.setdefault ('kl', '') 
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# 设置 Session 的 值 ， 键 为 kx1， 值 为 123 


request.session['k1'] = 123 


# 删除 session 中 k1 的 数据 
del request.session['k1'] 
# 删除 整个 Session 


request.session.clear() 


# 获取 session 的 键 
request.session.keys() 
# 获取 Session 的 值 


Frequest.session.values () 


# 获取 session 的 session _key， 即 数据 表 django_session 的 字段 session_key 
request.session.session key 


我 们 通过 实例 来 讲述 在 开发 过 程 中 如 何 使 用 Session。 以 MyDjango 为 例 ， 使 用 


Session 实现 购物 车 功能 ， 在 首页 找到 4 个 商品 信息 ， 每 个 商品 有 “立即 抢购 ”按钮 ， 


如 图 

















10-5 所 示 。 

HUAWEI P9 Plus 荣 意 畅 玩 5C 
ts, WETS 1 二 元 本 上风 虹 
5P6al008 was 5Pl0Blo0smRF 
*3988 EE *899 EE 

a 鞠 证 7 荣 洽 畅 玩 5X 
Ea mnie Ric 
a 999 e200 5 本 1008/2000 全 4 三 
“1799 EE “09 EZ 

图 10-5 首页 的 商品 信息 


购物 车 功能 的 实现 思路 如 下 : 





@ 。 当 用 户 单 击 “ 立 即 抢购 ”按钮 时 ， 该 按钮 会 触发 一 个 GET 请 求 并 将 商品 信息 
作为 请 求 参数 传 给 视图 函数 处 理 。 

。 视图 函数 接收 GET 请 求 后， 将 请 求 参数 保存 在 Session 中 并 返回 首页 ， 即 刷 
新 当前 网 页 。 

@ 当 用 户 进 入 购物 车 页 面 时 ， 程 序 获取 Session 里 的 数据 ， 并 将 数据 展示 在 购物 
车 列表 中 。 
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e@ 用 户 在 购物 车 页 面 单 击 某 个 商品 的 “ 移 除 商品 ”按钮 时 ， 程 序 在 Session 中 删 
除 该 商品 信息 。 











在 实现 购物 车 功能 之 前 ， 我 们 对 MyDjango 的 目录 架构 进行 细微 的 调整 ， 在 





index 中 新 增 模板 ShoppingCarhtml 以 及 模板 文件 相应 的 JS 和 CSS 文 件 ,如 图 10-6 所 示 。 





Y Bindex 
》 加 migrations 
~ 四 static 
v Bcss 


访 hw_jindex.css 

















| 


10-6 调整 项 目 架构 











购物 车 功能 由 index 的 urls.py、 views.py、index.html 和 ShoppingCarhtml 共同 实现 ， 


网 站 的 首页 主要 实现 Session 的 写 入 ， 购 物 车 页 面 实现 Session 的 读 取 和 删除 操作 。 首 
先 编写 urls.py 和 views.py 的 代码 ， 分 别 对 首页 和 购物 车 页 面 配置 URL 地 址 和 相应 的 
视图 函数 ， 代 码 如 下 : 


# urls.py 配置 路 由 
from django.urls import path 
from . import views 
urlpatterns = [ 
# 首页 的 URL 
path('', views.index, name='index'), 
# 购物 车 
path('shoppingCar.html', views.ShoppingCarView, name='ShoppingCar') 
] 


# views.py 
from django.shortcuts import render,redirect 
from django.contrib.auth.decorators import login required, permission_ 


required 


# 视图 函数 index 
# 使 用 1login required 和 permission required 分 别 对 用 户 登 录 和 用 户 权限 进行 验证 
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elogin required(login url="'/user/login.html') 
@permission required (perm="'index.visit Product', login url='/user/login. 
html') 
def index(request): 
# 获取 GET 请 求 参 数 
product = request.GET.get ('product', '') 
price = request.GET.get ('price', '') 
if product: 
# 获取 存储 在 Session 中 的 数据 ， 若 Session 不 存在 product info， 则 返回 一 个 空 列表 
Product list = request.session.get('product info', []) 
# 判断 当前 请 求 参 数 是 否 已 存储 在 Session 
if not product in product list: 
# 将 当前 参数 存储 在 列表 product_1ist 中 
product list.append({'price': price, 'product': product}) 
# 更 新 存储 在 Session 中 的 数据 
request.session['product info'] = product list 
return redirect('/') 
return render(request, 'index.html', locals()) 


图 





# 视图 函数 SshoppingCarView 
@login required(login url='/user/login.html') 
def ShoppingCarView (request): 
# 获取 存储 在 Session 中 的 数据 ， 若 Session 中 不 存在 product_info， 则 返回 一 个 空 列表 
product list = request.session.get('product info', []) 
# 获取 GET 请 求 参 数 ， 若 没有 请 求 参 数 ， 则 返回 空 值 
del product = request.GET.get('product', '') 
# 判断 是 否 为 空 ， 若 非 空 ， 则 删除 Session 中 的 商品 信息 
if del product: 

# 删除 Session 中 某 个 商品 数据 
for i in product list: 

if i['product'] == del product: 

product_ list.remove (i) 

# 将 删除 后 的 数据 覆盖 原来 的 Session 
request.session['product info'] = product list 
return redirect('/sShoppingCar.html') 

return render (equest， 'ShoppingCar.html', locals()) 


函数 index 的 功能 实现 如 下 : 

e。 首先 获取 GET 请 求 的 请 求 参 数 ， 若 当前 请 求 没有 请 求 参数 ， 则 变量 product 
和 price 为 空 ， 否 则 分 别 将 请 求 参 数 赋予 变量 product 和 price。 

e ”获取 当前 用 户 Session 的 product info 数据 信息 并 赋值 给 变量 product list。 


日 “判断 product list 是 否 已 存 有 product 和 price， 若 不 存在 ， 则 将 product 和 price 
写 入 product list。 
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。 最 后 将 product list 重新 写 入 Session 并 重 定 向 首页 地 址 。 
函数 ShoppingCarView 的 功能 实现 如 下 : 


@ 首先 获取 当前 用 户 Session 的 product info 数据 信息 。 

。 获取 当前 请 求 参 数 product 并 赋值 给 变量 del product， 若 不 存在 请 求 参 数 ， 则 
变量 del product 为 空 值 。 

e@ 如果 变量 del product 不 为 空 ， 而 且 product list 已 存在 变量 del product， 那 么 
在 product list 中 删除 变量 del product。 

。 最 后 将 product list 重新 写 入 Session 的 product info， 并 重 定 向 购物 车 的 网 页 
地 址 。 


从 函数 mdex 和 ShoppingCarView 的 功能 实现 过 程 中 可 以 发 现 ， 两 者 对 Session 
的 处 理 有 相似 的 地 方 : 首先 从 Session 中 获取 数据 内 容 , 然后 对 数据 内 容 进行 读 写 处 理 ， 
最 后 将 处 理 后 的 数据 内 容重 新 写 入 Session。 


当 视 图 函数 处 理 用 户 请 求 后 ， 再 由 模板 生成 相应 的 网 页 返回 给 用 户 。 我 们 分 别 
对 模板 index.html 和 ShoppingCarhtml 进行 修改 ， 由 于 模板 文件 代码 较 长 ， 此 处 只 展 
示 修 改 的 代码 ， 完 整 的 代码 可 在 本 书 下 载 资源 中 查看 ， 代 码 修改 如 下 : 


# 模板 index.html 
# 设置 购物 车 的 网 页 地 址 
<div class="1f"” id="my_hw"> 我 的 商城 </div> 
<div class="1f"” id="settle up"><a href="{% url 'ShoppingCar' %}"> 我 的 购物 
车 </a></div> 
# 设置 " 立即 抢购 " 按钮 的 链接 地 址 ， 此 处 只 列 出 一 个 商品 的 设置 方式 ， 剩 余 商 品 的 设置 是 相同 的 
<1i class="channel-pro-item"> 
<!--<i class="p-tag"><img src="img/new ping.png" style="padding-left: 0" 
alt=""/></i>==> 
<div class="p-img"> 
<img src="{% static "img/phone01.png" %}" alt=""/> 
</div> 
<div class="p-name lf"><a href="#">HUAWEI P9 Plus</a></div> 
<div class="p-shining"> 
<div class="p-slogan"> 一 上 手 ， 就 爱不释手 </div> 
<div class="p-promotions">5 月 6 日 10:08 火爆 开 售 </div> 
</div> 
<div class="p-price"> 
<em>¥</em> 
<span>3988</span> 
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</div> 
<div class="p-button 1f"> 
# 设置 带 参 数 的 GET 请 求 ， 请 求 参 数 为 product 和 price 
<a href="{% url 'index' $}?product=HUAWEI P9 Plusgprice=3988"> 立即 抢购 
</a> 
</div> 
pL 


# 模板 shoppingCar.html 
<div class="order content"> 
# 变量 product_1ist 来 自 于 视图 函数 的 变量 product list 
{% for info in product list %} 
<ul class="order lists"> 
<1i class="list chk"> 
<input type="checkbox" id="checkbox 4" class="son check"> 
<label for="checkbox 4"></label> 
</1i> 
<1li class="1ist_con"> 
# 商品 名 称 


<div class="list text"><a href="javascript:;">{{ info.product }1</a></ 





div> 
</1i> 
<1i class="list price"> 
# 商品 价格 
<p class="price">¥{{ info.price }}</p> 
</1i> 
<1i class="list amount"> 
<div class="amount box"> 
<a href="javascript:;" class="reduce TeSty">-</a> 
<input type="text" Value="1"” class="sum"> 
<a href="javascript:;" class="plus">+</a> 
</div> 
</1i> 
<1i class="list sum"> 
<p class="sum price">¥{{ info.price }1</p> 
</1i> 
<1i class="list op"> 
<p class="del"> 
# 设置 带 参数 的 GET 请 求 ， 请 求 参 数 为 product 
<a href="{% url 'ShoppingCar' %}?product={{ info.product }}" 
class="delBtn"> 移 除 商品 </a> 
</p> 
</1i> 
</ul> 
{$$ endfor 要 } 
</div> 


Eg 
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至 此 ， 我 们 已 完成 index 的 urlspy、viewspy、index.html 和 ShoppingCarhtml 的 
代码 编写 。 最 后 启动 MyDjango 测试 购物 车 功能 ， 测 试 方式 如 下 : 


ee 在 浏览 器 中 访问 http://127.0.0.1:8000/user/login.html?next=/， 输 入 用 户 信息 完 
成 用 户 登 录 。 

e 在 首页 的 商品 信息 中 单 击 “ 立 即 抢购 ”按钮 ， 同 一 商品 的 “立即 抢购 ”按钮 
可 以 重复 点 击 。 

ee 回 到 首页 顶部 ， 单 击 “ 我 的 购物 车 ”， 进 入 购物 车 页 面 ， 查 看 购物 车 中 的 商 
品 信息 是 否 有 重复 。 

e 在 购物 车 页 面 单 击 某 商 品 的 “ 移 除 商品 ”按钮 并 刷新 网 页 ， 观 察 购物 车 中 的 
商品 是 否 已 删除 。 


在 上 述 例子 中 , Diango 只 实现 了 商品 列表 生成 “ 移 除 商品 ”按钮 和 设置 首页 地 址 ， 
其 余 的 功能 都 是 由 前 端的 JavaScript 实现 的 。 购 物 车 页 面 如 图 10-7 所 示 。 





图 10-7 购物 车 页 面 效 果 图 


10.2 缓存 机 制 


现在 的 网 站 都 以 动态 网 站 为 主 ， 当 网 站 访问 量 过 大 时 ， 网 站 的 响应 速度 必然 会 降 
低 ， 这 就 有 可 能 出 现 卡 死 的 情况 。 为 了 解决 网 站 访问 量 过 大 的 问题 ， 可 以 在 网 站 上 使 
用 缓存 机 制 。 

缓存 是 将 一 个 请 求 的 响应 内 容 保存 到 内 存 或 者 高 速 缓存 系统 (Memcache) 中 
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若 某 个 时 间 内 再 次 发 生 同 一 个 请 求 ， 则 不 再 去 执行 请 求 响应 过 程 ， 而 是 直接 从 内 存 或 
者 高 速 缓存 系统 中 获取 该 请 求 的 响应 内 容 返 回 给 用 户 。 
Django 提供 5 种 不 同 的 缓存 方式 ， 每 种 缓存 方式 说 明 如 下 : 


Memcached: 一 个 高 性 能 的 分 布 式 内 存 对 象 缓存 系统 ， 用 于 动态 网 站 ， 以 减 
轻 数据 库 负载 。 通 过 在 内 存 中 缓存 数据 和 对 象 来 减少 读 取 数 据 库 的 次 数 ， 从 
而 提高 网 站 的 响应 速度 。 使 用 Memcached 需要 安装 系统 服务 器 ，Django 通过 
python-memcached 或 pylibmc 模块 调用 Memcached 系统 服务 器 ， 实 现 缓存 读 
写 操作 ， 适 合 超大 型 网 站 使 用 。 

数据 库 缓存 : 缓存 信息 存储 在 网 站 数据 库 的 缓存 表 中， 缓存 表 可 以 在 项 目的 
配置 文件 中 配置 ， 适 合 大 中 型 网 站 使 用 。 

文件 系统 缓存 : 缓存 信息 以 文本 文件 格式 保存 ， 适 合 中 小 型 网 站 使 用 。 

本 地 内 存 缓存 :Django 默认 的 缓存 保存 方式 ， 将 缓存 存放 在 项 目 所 在 系统 的 
内 存 中 ， 只 适用 于 项 目 开发 测试 。 

虚拟 缓存 : Django 内 置 的 虚拟 缓存 ， 实 际 上 只 提供 缓存 接口 ， 并 不 能 存储 缓 
存 数 据 ， 只 适用 于 项 目 开发 测试 。 


每 种 缓存 方式 都 有 一 定 的 适用 范围 ， 因 此 选择 缓存 方式 需要 结合 网 站 的 实际 情 
况 而 定 。 若 在 项 目 中 使 用 缓存 机 制 ， 则 首先 需要 在 配置 文件 settings.py 中 设置 缓存 的 
相关 配置 。 每 种 缓存 方式 的 配置 如 下 : 


# Memcached 配置 
# BACKEND 用 于 配置 缓存 引擎 ，LOCATION 是 Memcached 服务 器 的 IP 地 址 


# django.core.cache.backends .memcached.MemcachedCcache 使 用 python-memcached 


模块 连接 Memcached 
# django .core.cache.backends .memcached.PyLibMCCache 使 用 pylibmc 模块 连接 
Memcached 
CACHES = { 
'default': { 
'BACKEND': '‘'django.core.cache.backends.memcached.MemcachedCache', 
# 'BACKEND': 'django.core.cache.backends.memcached.PyLibMCCache, 
'LOCATION': [ 
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"172<19.26.240:11211°, 
"172.19.26.242:11211"; 
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# 数据 库 缓存 配置 
# BACKEND 用 于 配置 缓存 引擎 ，LOCATION 用 于 数据 表 的 命名 
CACHES = { 
'default': { 
'BACKEND': 'django.core.cache.backends.db.DatabaseCache', 


'LOCATION': 'my cache table', 
’ 


# 文件 系统 缓存 
# BACKEND 用 于 配置 缓存 引擎 ，LOCATION 是 文件 保存 的 路 径 
CACHES = { 
"default': { 
'BACKEND': '‘'django.core.cache.backends .filebased.FileBasedCache', 
'LOCATION': 'e:/django cache', 


} 


# 本 地 内 存 缓存 
# BACKEND 用 于 配置 缓存 引擎 ，LOCATION 对 存储 器 命名 ， 用 于 识别 单个 存储 器 
CACHES = { 
'default': { 
'BACKEND': 'django.core.cache.backends.locmem.LocMemCache', 
'LOCATION': 'unique-snowflake', 
} 
} 
# 虚拟 缓存 
# BACKEND 用 于 配置 缓存 引擎 
CACHES = { 
"default': { 


'BACKEND': 'django.core.cache.backends.dummy.DummyCache', 
} 


上 述 缓存 配置 仅仅 是 基本 配置 ， 也 就 是 说 缓存 参数 BACKEND 和 LOCATION 是 
必须 配置 的 ， 其 余 的 配置 参数 可 自行 选择 。 我 们 以 数据 库 缓存 配置 为 例 ， 完 整 的 缓存 
配置 如 下 : 


CACHES = { 
# 默认 缓存 数据 表 
"default': { 
'BACKEND': "django .core-cache.-backendqs .db.DatabaseCache' 
"LOCRATION ' : 'my cache table', 
# TIMEOUT 设置 缓存 的 生命 周期 ， 以 秒 为 单位 ， 若 为 None， 则 永 不 过 期 
'TIMEOUT': 60， 
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"OPTIONS': { 
# MAX ENTRIES 代表 最 大 缓存 记录 的 数量 
'MAX ENTRIES': 1000, 
# 当 缓 存 到 达 最 大 数量 之 后 ， 设 置 剔 除 缓存 的 数量 
'CULL FREQUENCY': 3, 
} 


}, 

# 设置 多 个 缓存 数据 表 

'MyDjango':{ 
'BACKEND': ‘django.core.cache.backends.db.DatabaseCache', 
'LOCATION': 'MyDjango cache table', 


} 


在 配置 文件 完成 数据 库 缓存 配置 后 ， 下 一 步 是 在 数据 库 中 创建 缓存 数据 表 ， 绥 
存 数据 表 的 生成 依赖 于 配置 文件 中 DATABASES 的 配置 信息 。 需 要 注意 的 是 ， 如 果 
DATABASES 配置 了 多 个 数据 库 ， 那 么 缓存 数据 表 默 认 在 DATABASES 的 default 的 
数据 库 中 生成 。 在 PyCharm 的 Terminal 中 输入 python manage.py createcachetable 指令 
创建 缓存 数据 表 ， 然 后 在 数据 库 中 查看 缓存 数据 表 ， 如 图 10-8 所 示 。 





auth_group 

转 auth_group_permissions 

auth_permission 

django_admin_log 

围 django_content type 

围 django_migrations 

国 django_session 

国 index_product 
x typ 
























my_cache table 


mydjango_cache table 











user_ myuser_ user_permissions 


图 10-8 创建 缓存 数据 表 




















在 项 目 中 完成 缓存 的 配置 ， 创 建 缓存 数据 表 之 后 ， 就 可 以 在 项 目 中 使 用 缓存 了 。 
缓存 的 使 用 方式 有 4 种 ， 主 要 根据 使 用 对 象 的 不 同 来 划分 ， 有 具体 说 明 如 下 。 





e 全 站 缓存 将 缓存 作用 于 整个 网 站 的 全 部 页 面 。 一 般 情 况 下 不 采用 这 种 方式 
实现 ， 如 果 网 站 规模 较 大 ， 缓 存 数据 相应 增多 ， 就 会 对 数据 库 或 Memcached 
造成 极 大 的 压力 。 

e 视图 缓存 : 当 用 户 发 送 请 求 时 ， 若 该 请 求 的 视图 函数 已 生成 缓存 ， 则 返回 缓 
存 数据 ， 这 样 可 省 去 视图 函数 处 理 请 求 信 息 的 时 间 和 资源 。 
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路 由 (URL) 缓存 : 其 作用 与 视图 缓存 相同 ， 但 两 者 是 有 区 别 的 ， 例 如 有 两 
个 URL 同时 指向 一 个 视图 函数 ， 分 别 访问 这 两 个 URL 时 ， 路 由 缓存 会 判断 
URL 是 否 生 成 缓存 而 决定 是 否 执行 视图 函数 。 

模板 缓存 : 对 模板 某 部 分 的 数据 设置 缓存 ， 常 用 于 模板 内 容 变 动 较 少 的 情况 ， 
如 HTML 的 <head> 标签 ， 设 置 缓 存 能 省 去 模板 引擎 解析 生成 HIML 页 面 的 
时 间 。 


全 站 缓存 作用 于 整个 网 站 ， 当 用 户 向 网 站 发 送 请 求 时 ， 首 先 经 过 Django 的 中 间 
件 进行 处 理 。 因 此 ， 使 用 全 站 缓存 应 在 Django 的 中 间 件 中 配置 ， 配 置信 息 如 下 : 


# settings .py 配置 信息 
MIDDLEWARE = [ 


# 配置 全 站 缓存 
'django.middleware.cache.UpdateCacheMiddleware', 
'django.middleware.security.SecurityMiddleware', 
'django.contrib.sessions.middleware.SessionMiddleware', 

# 使 用 中 文 

'django.middleware.locale.LocaleMiddleware', 

'django .middleware.common.CommonMiddleware', 
'django.middleware.csrf.CsrfViewMiddleware', 
'django.contrib.auth.middleware.AuthenticationMiddleware', 
'django.contrib.messages.middleware.MessageMiddleware', 
'django.middleware.clickjacking.XFrameOptionsMiddleware', 
# 配置 全 站 缓存 


'django.middleware.cache.FetchFromCacheMiddleware', 


] 

# 设置 缓存 的 生命 周期 

CACHE MIDDLEWARE SECONDS = 15 

# 设置 缓存 数据 保存 在 数据 表 my_cache_table 中 ， 属 性 值 default 来 自 于 缓存 配置 CACHES 的 
default 属性 

CACHE MIDDLEWARE ALIAS = 'default' 

# 设置 缓存 表 字 段 cache_key 的 值 ， 用 于 同一 个 Django 项 目 多 个 站 点 之 间 的 共享 缓存 

CACHE MIDDLEWARE KEY PREFIX = 'MyDjango' 


全 站 缓存 配置 说 明 如 下 : 


在 中 间 件 的 最 上 方 和 末端 分 别 添加 中 间 件 UpdateCacheMiddleware 和 
FetchFromCache Middleware。 

CACHE MIDDLEWARE SECONDS 设置 全 站 缓存 的 生命 周期 。 若 在 
缓存 配置 CACHES 中 设置 TIMEOUT 属性 ， 则 程序 优先 选择 CACHE _ 
MIDDLEWARE SECONDS 的 设置 。 
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。 CACHE MIDDLEWARE ALIAS 设置 缓存 的 保存 路 径 ， 黑 认为 default。 因 为 
在 缓存 配置 CACHES 中 设置 两 个 缓存 数据 表 ， 而 属性 值 default 对 应 缓存 配置 
CACHES 的 default 属性 ， 所 以 全 站 缓存 将 保存 在 数据 表 my_cache table 中 。 

e CACHE MIDDLEWARE KEY PREFIX 指定 某 个 Django 站 点 的 名 称 。 在 一 些 
大 型 网 站 中 都 会 采用 分 布 式 站 点 实现 负载 均衡 ， 就 是 将 同一 个 Django 项 目 部 
署 在 多 个 服务 器 上 ， 当 网 站 访问 量 过 大 的 时 候 ， 可 以 将 访问 量 分 散 到 各 个 服 
务 器 ， 提 高 网 站 的 整体 性 能 。 如 果 多 个 服务 器 使 用 共享 缓存 ， 那 么 该 属性 的 
作用 是 为 了 区 分 各 个 服务 器 的 缓存 数据 ， 这 样 每 个 服务 器 只 能 使 用 自己 的 缓 
存 数 据 。 


启动 MyDiango， 在 浏览 器 上 访问 的 页 面 都 会 在 缓存 数据 表 my_cache table 上 生 
成 相应 的 缓存 信息 ， 如 图 10-9 所 示 。 


Er 
入 和 各 国务 注 " 了 下 膨 半 路 SA 车 3 
Value expires 
AsvEeAAAAAAAAsdIvlsFRUUF3DT09Lsuvruyz2018 03.30 
che_header MyCjargo 3345s87a9ASVE9AAAAAAAABdHwSFRUUF9DTO9LSUNWUY 2018-03-30 
che header,MyDiangc.3fis3f14c 9ASVE9AAAAAAAASdWwLSFRUUF3DT09LSUWUY 2018-03-30 
ot 5 上 Ery7abfs 9AsvesyAAAAAACMFGRqywsnby5odHRwtLmjlc 2018-03-30 
MyDjango FET 3345et OASVaQOAAAAAAACMFGRAYWSnibySodHRwtn) 2018-03-30 
sche_pegd MyDjongoFET.3HB3f1 9gAsVwgYAAAAAAACMFGRqYW5nby5cdHRwLmyk 2018-03-30 


CACHE_MIDDLEWARE_KEY_PREFIX 的 属性 秆 


mwiwman 问 口 
于 笛 





图 10-9 缓存 数据 表 my_cache_table 


视图 缓存 是 将 视图 函数 执行 过 程 生 成 缓存 数据 ， 主 要 以 装饰 器 的 形式 来 实现 。 装 
饰 器 有 三 个 参数 ， 分 别 是 timeout、cache 和 key_prefix， 参 数 timeout 是 必 选 参数 ， 其 
余 两 个 参数 都 是 可 选 参数 ， 参 数 的 含义 与 视图 缓存 的 参数 一 致 。 其 代码 如 下 : 


# App (index) 的 views.py 
# 导入 cache page 
from django.views.decorators.cache import cache page 
# 参数 cache 与 全 站 缓存 CACHE_MIDDLEWARE_ALIAS 相同 
# 参数 key_prefix 与 全 站 缓存 CACHE_MIDDLEWARE KEY_PREFIX 相同 
@cache page (timeout=10, cache='MyDjango', key prefix='MyDjangoView') 
@login required(login url='/user/login.html') 
def ShoppingCarView (request): 
pass 
return Trender (equest， 'ShoppingCar.html', locals()) 
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在 浏览 器 上 访问 购物 车 页 面 ， 打 开 数 据 库 查看 缓存 数据 表 mydjango_cache table 
的 视图 缓存 信息 ， 如 图 10-10 所 示 。 


文件 沪 铝 查看 窜 品 帮助 
和 事务 。 国 备 主 - 可 让 胖 拓 施 四 S 转 Sd 
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cache key value expires 
EE osvaw sac2010 .0-30 0251.300000 


:1views.decorators.cache.cache_page.MyDjangoView.GET.334€ gASV9AoAAAAAAACN 2018-03-30 02:51:31.0000 


v 


+-/x*xee 





图 10-10 缓存 数据 表 mydjango_cache_table 


路 由 缓存 主要 在 路 由 配置 urls.py 中 实现 ， 路 由 缓存 cache_page 有 三 个 参数 ， 分 
别 是 timeout、cache 和 key_prefix， 参 数 timeout 是 必 选 参数 ， 其 余 两 个 参数 都 是 可 选 
参数 ， 参 数 的 含义 与 视图 缓存 的 参数 一 致 。 实 现代 码 如 下 : 


from django .ur1s import path 
from . import views 
from django.views.decorators.cache import cache page 


urlpatterns = [ 


# 首页 的 URL 
path('', cache page(10, 'MyDjango', 'MyDjangoURL') (views.index), 


name='index'), 


# 购物 车 


path('SshoppingCar.html', views.ShoppingCarView, name='ShoppingCar') 
] 


在 浏览 器 上 访问 某 个 页 面 ， 打 开 数 据 库 查看 缓存 数据 表 mydjango_cache table 的 
缓存 信息 ， 如 图 10-11 所 示 。 
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value expires 
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10-11 缓存 数据 表 mydjango_cache table 











模板 缓存 是 通过 Django 的 缓存 标签 实现 的 ， 缓 存 标签 只 支持 两 个 参数 : timeout 
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和 key_prefix， 以 模板 index.html 为 例 实现 模板 缓存 ， 代 码 如 下 : 


<ul class="rt"> 
{# 设置 缓存 #} 
{$s load cache $%} 
{% cache 10 MyDjangoTemp %} 
{# 在 模板 中 使 用 的 user 变量 是 一 个 User 或 者 AnoymousUser 对 象 ， 该 对 象 由 模型 MyUser 实 
例 化 #} 
{% if user.is authenticated $%} 
<l1i> 用 户 名 : {{ user.username }}</1i> 
<li><a href="{g%g url 'logout' $}"> 退 出 登录 </a></1i> 
{% endif %} 
{# 在 模板 中 使 用 的 perms 变量 是 Permission 对 象 ， 该 对 象 由 模型 Permission 实例 化 #} 
{% if perms.index.add product %} 
<1i> 添加 产品 信息 </1i> 
{% endif %} 
{# 缓存 结束 #} 
{% endcache %} 
</ul> 


模板 缓存 的 缓存 信息 会 默认 存储 在 数据 表 my_cache_table 中 ， 打 开 数 据 库 查看 数 
据 表 my_cache_table 的 模板 缓存 信息 ， 如 图 10-12 所 示 。 
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10-12 缓存 数据 表 my_cache table 








10.3 CSRF 防护 





CSRF (Cross-Site Request Forgery， 跨 站 请 求 伪造 ) 也 称 为 One Click Attack 或 者 
Session Riding， 通 常 缩写 为 CSRF 或 者 XSRF， 是 一 种 对 网 站 的 恶意 利用 ， 人 窃取 网 站 
的 用 户 信息 来 制造 恶意 请 求 。 

Django 为 了 防护 这 类 攻击 ， 在 用 户 提交 表单 时 ， 表 单 会 自动 加 入 csrftoken 的 隐 
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含 值 ， 这 个 隐 含 值 会 与 网 站 后 台 保 存 的 csrftoken 进行 匹配 ， 只 有 匹配 成 功 ， 网 站 才 会 
处 理 表单 数据 。 这 种 防护 机 制 称 为 CSRF 防护 ， 原 理 如 下 : 





e 在 用 户 访问 网 站 时 ，Django 在 网 页 的 表单 中 生成 一 个 隐 含 字段 csrftoken， 这 
个 值 是 在 服务 器 端 随机 生成 的 。 

e@ 当 用 户 提交 表单 时 ， 服 务 器 校 验 表单 的 csrftoken 是 否 和 自己 保存 的 csrftoken 
一 致 ， 用 来 判断 当前 请 求 是 否 合法 。 

@ 如 果 用 户 被 CSRF 攻击 并 从 其 他 地 方 发 送 攻击 请 求 ， 由 于 其 他 地 方 不 可 能 知 
道 隐 藏 的 csrftoken 信息 ， 因 此 导致 网 站 后 台 校 验 csrftoken 失败 ， 攻 击 就 被 成 


功 防 御 。 





在 Django 中 使 用 CSRF 防 护 功能 首先 在 配置 文件 settings.py 中 设置 防 
护 功 能 的 配置 信息 。 功 能 的 开启 由 配置 文件 的 中 间 件 django.middleware.csrf. 
CsrfViewMiddleware 实现 ， 在 创建 项 目 时 已 默认 开启 ， 如 图 10-13 所 示 。 











MIDDLEWARE = [ 
* 配 辕 全 站 绎 存 
ddleware, cache. UpdateCacheliddleware'， 
"django. aiddleware. security. SecurityMiddlevare’, 
po. contrib, sessions. niddleware. SessionMiddleware’, 







nMiddleware” , 
" django. contrib, nessages. niddleware. Messageliddleware’, 









"django. middleware, clickjacking. XPraneOptionsMiddleware” , 
7 配 纤 存 
"django. niddleware. cache. 了 etchprosCacheliddleware ， 





图 10-13 设置 CSRF 防护 





CSRF 防护 只 作用 于 POST 请 求 ， 并 不 防护 GET 请 求 ， 因 为 GET 请 求 以 只 读 形 


式 访问 网 站 资源 ， 

















不 破坏 和 算 改 网 站 数据 。 以 MyDjango 为 例 ， 在 模板 userhtml 的 








表单 <form> 标签 中 加 入 内 置 标签 csrf token 即 可 实现 CSRF 防护 ， 代 码 如 下 : 


# 模板 user.html 部 分 代码 

<form class="form" action="" method="post"> 

{g csrf token $%} 

<div> 用 户 名 :<input type="text" name='username'></div> 


<div> 密 码 :<input type="password" name='password'></div> 
<button type="submit" class="btn btn-primary btn-block"> 确定 </button> 


</form> 
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启动 运行 MyDjango， 在 浏览 器 中 打开 用 户 登录 页 面 ， 然 后 查看 页 面 的 源码 ， 可 
以 发 现 表 单 新 增 隐藏 域 ， 隐 藏 域 是 由 模板 语法 {9%%6 csrf token %} 所 生成 的 ， 网 站 生成 
的 csrftoken 都 会 记录 在 隐藏 域 的 value 属性 中 。 当 用 户 每 次 提交 表单 时 ，csrftoken 都 
会 随 之 变化 ， 如 图 10-14 所 示 。 













lewaretoken” value="vJNhdRaqlVowXwS5uxRX7nTvPS51UGLrd71X09FGQWL8cSTjJL122MwYFJhZvAWEESZ"™> 
"用 户 各: 


input type="text" name="username™ 
/div> 


input type="password” name="password" 
/div> 
button type="submit” class="btn btn-primary btn-block"> 确 定 </button 
/form; 




















10-14 csrftoken 信息 





如 果 想 要 取消 表单 的 CSRF 防护 ， 可 以 在 模板 上 删除 {% csrf token %}， 并 且 在 
相应 的 视图 函数 中 添加 装饰 器 @csrf_exempt， 代 码 如 下 : 


from django.views.decorators.csrf import csrf exempt 
# 取消 CSRF 防护 
@csrf exempt 
def registerView (request): 
pass 
return render(request, 'user.html', locals()) 


如 果 只 是 在 模板 上 删除 {% csrf token %}， 并 没有 在 相应 的 视图 函数 中 设置 过 滤 
器 @csrf exempt， 那 么 当 用 户 提交 表单 时 ， 程 序 因 CSRF 验证 失败 而 抛 出 403 异常 的 
页 面 ， 如 图 10-15 所 示 。 














D 03 Forbidden x 得 
€ 3 C|@01270018000/userloginhtmfnext=/ 








禁止 访问 soy 


CSRFE 玫 请求 读 中 匠 
Help 


Reason given for failure: 
CIE ten nianing ee ineorreet 


Ingeneral this can occur when there is a genuine Cross Site Request Forgery. or when Djanoo's CSRF mechanism has rot been used comecty For POST forms. you need to ensure: 
» Your browser is accepting cookies 
«The view function passes a roases to the template's reader method- 
» In the templete. there is 3 fy csrf_tohex gl femplate tag nside each POST form thet targets an infemal URL 
fyou are not using carve ll see, then you must Use varE 3rstvrt On any View that use the esré teben template tag ak well as those that accept the POST data. 


» The form has a valid CSRF token. Afterlogging in in another browser tab or hiting the back button sier alogin you may need to reload the page with the form 
because the token ks rotated after 2 login- 


You're seeing the help section of this page because you have 2am = Tree in your Django settings fle. Change that to False nd cniy the initial error message will be displayed 
You can customize this page using the CSRF_FAILURE VIEW setting. 














图 10-15 CSRF 验证 失败 
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最 后 还 有 一 种 比较 特殊 的 情况 ， 如 果 在 配置 文件 settingspy 中 删除 中 间 件 
CsrfViewMiddleware， 这 样 使 整个 网 站 都 取消 CSRF 防护 。 在 全 站 没有 CSRF 防护 的 
情况 下 ， 又 想 对 某 些 请 求 设置 CSRF 防护 ， 那 么 在 模板 上 添加 模板 语法 {% csrf token 
%}， 然 后 在 相应 的 视图 函数 中 添加 装饰 器 @csrf protect 即 可 实现 ， 代 码 如 下 : 


from django.views.decorators.csrf import csrf protect 
# 添加 CSRE 防护 
@csrf protect 
def registerView (request): 
pass 
return render(request, 'user.html', locals()) 


值得 注意 的 是 ， 在 日 常 开发 中 ， 如 果 网 页 某 些 数据 是 使 用 前 端的 Ajax 实现 表单 
提交 的 ,那么 Ajax 向 服务 器 发 送 POST 请 求 时 ， 请 求 参数 必须 添加 csrftoken 的 信息 ， 
否则 服务 器 会 视 该 请 求 是 恶意 请 求 。 实 现代 码 如 下 : 


<script> 
function submitForm(){ 
Var csrf = $('input[name="csrfmiddlewaretoken"] ') .val (); 
Var user = $('#user') .val (); 
Var password = $('#password') .val (); 
$.ajax({ 
Urls /csrflehtml', 
type: 'POST', 
data: {'user': user, 
'password': password, 
'csrfmiddlewaretoken': csrf}, 
success:function(arg){ 
console.log(arg); 
} 
]) 
} 
</script> 


10.4 消息 提示 


在 网 页 应 用 中 ， 当 处 理 完 表单 或 完成 其 他 信息 输入 后 ， 网 站 会 有 相应 的 操作 
提示 。Django 有 内 置 消息 提示 功能 供 开 发 者 直接 使 用 ， 信 息 提示 功能 由 中 间 件 
SessionMiddleware、MessageMiddleware 和 INSTALLED APPS 的 django.contrib. 
messages 共同 实现 。 在 创建 Django 项 目 时 , 消息 提示 功能 已 默认 开启 , 如 图 10-16 所 示 。 
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“django. contrib. staticfiles 
"index’, 


poL wapE = 1 
"django. niddleware. security. Securiry Widdlevare”. 














图 10-16 消息 提示 功能 配置 


消息 提示 必须 依赖 中 间 件 SessionMiddleware， 因 为 消息 提示 的 引擎 默认 是 
SessionStorage， 而 SessionStorage 是 在 Session 的 基础 上 实现 的 ， 同 时 说 明了 中 间 件 
SessionMiddleware 为 什么 设置 在 MessageMiddleware 的 前 面 。 

使 用 信息 提示 功能 之 前 , 需要 了 解 消息 提示 的 类 型 , Django 提供 了 5 种 消息 类 型 ， 
说 明 如 表 10-2 所 示 。 

表 10-2 Dijango 提 供 的 5 种 消息 类 型 


DEBUG 提示 开发 过 程 中 的 相关 调试 信息 
INFO 这 息 ， 如 用 户 信息 


SUCCESS 提示 当前 操作 执行 成 功 
WARNING 警告 当前 操作 存在 风险 
提示 当前 操作 错误 








若 想 在 开发 中 使 用 消息 提示 ， 首 先 在 视图 函数 中 生成 相关 的 信息 内 容 ， 然 后 在 
模板 中 将 信息 内 容 展 现在 网 页 上 。 因 此 ， 在 index 中 定义 相关 的 URL 地 址 和 相应 的 
视图 函数 ， 代 码 如 下 : 




















# urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
# 首页 的 URL 
path('', views.index, name="'index'), 


# 购物 车 
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Path ('ShoppingCar-htm1l'，Views .ShoppingCarView，name='ShoppingCar')yv 
# 消息 提示 


path('message.html', views.messageView, name='message’'), 


# views.py 
from django.contrib import messages 
from django.template import RequestContext 
# 消息 提示 
def messageView (request): 
# 信息 添加 方法 一 
messages.info(request， ' 信息 提示 ') 
messages.success (request， ' 信息 正确 ') 
messages.warning (request， ' 信息 警告 ') 
messages.error (request， ' 信息 错误 ') 
# 信息 添加 方法 二 
messages.add message (request, messages.INFO, ' 信息 提示 ' ) 
return render (request, 'message.html', locals(), RequestContext (request)) 


在 视图 函数 messageView 中 可 以 看 到 添加 信息 有 两 种 方式 ， 两 者 实现 的 功能 是 一 
样 的 。 在 函数 返回 时 ， 必 须 设置 RequestContext(request)， 这 是 Django 的 上 下 文 处 理 
器 ， 确 保 信 息 messages 对 象 能 在 模板 中 使 用 。 最 后 在 index 的 templates 中 创建 模板 
message.html， 模 板 代码 如 下 : 


<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="UTF-8"> 
<title> 信息 提示 </title> 
</head> 
<body> 
{% if messages %} 
<ul> 
{g for message in messages $%} 
{# message.tags 代表 信息 类 型 #} 
<li{% if message.tags %} class="{{ message.tags }}"{% 
endif %$}>{{ message }}</1i> 
{% endfor %} 
</ul> 
{% else %} 
<script>alert (' 暂 无 信息 ') ;</script> 
{% endif %} 
</body> 
</html> 


在 上 述 例 子 中 ， 视 图 函数 messageView 将 对 象 messages 通过 上 下 文 处 理 
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器 RequestContext(request) 传递 给 模板 变量 messages， 然 后 将 模板 变量 messages 
的 内 容 遍 历 输出 ， 最 后 通过 模板 引擎 解析 生成 HIML 网 页 。 在 浏览 器 上 访问 
http://127.0.0.1:8000/message.html， 网 页 信息 如 图 10-17 所 示 。 








D es 
€ 3 C {|® 12700t3000/messageniml 








， 信息 提示 
。 信息 正确 
。 信息 警告 
。 信息 错误 
， 信息 提示 





民间 Bements Console Sources Network Periormance Memoy Applicaton » 


“| Sayes Computed EvertUisteners » 


moy .cls + 




















在 网 页 上 浏览 数据 的 时 候 ， 数 据 列表 的 下 方 都 能 看 到 翻 页 功能 ， 而 且 每 一 页 的 
数据 都 不 相同 。 比 如 在 淘宝 上 搜索 某 商品 的 关键 字 ， 淘 宝 会 根据 用 户 提供 的 关键 字 返 
回 符合 条 件 的 商品 信息 ， 并 且 对 这 些 商品 信息 进行 分 页 处 理 ， 用 户 可 以 在 商品 信息 的 
下 方 单 击 相应 的 页 数 按钮 查看 。 

如 果 要 实现 数据 的 分 页 功能 ， 需 要 考虑 多 方面 因素 : 



































@ ”当前 用 户 访问 的 页 数 是 否 存 在 上 (下 ) 一 页 。 
@ 访问 的 页 数 是 否 超出 页 数 上 限 。 
e@ 数据 如 何 按 页 截取 ， 如 何 设置 每 页 的 数据 量 。 


Django 已 为 开发 者 提供 了 内 置 的 分 页 功能 , 开发 者 无 须 自 己 实现 数据 分 页 功能 ， 
只 需 调用 Django 内 置 分 页 功能 的 函数 即 可 实现 。 在 实现 网 站 数据 分 页 之 前 ， 首 先 了 
解 Django 的 分 页 功能 为 开发 者 提供 了 哪些 方法 与 函数 ， 在 PyCharm 的 Terminal 中 
启 Django 的 shell 模式 ， 函 数 使 用 说 明 如 下 : 
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E:\MyDjango>python manage.py shell 

# 导入 分 页 功能 模块 

>>> from django.core.paginator import Paginator 

# 生成 数据 列表 

>>> objects = [chr(x) for x in range(97,107)] 

>>> objects 

La "bY ev Td ver VME, ron Wh ML 可 
# 将 数据 列表 以 每 三 个 元 素 分 为 一 页 

>>> p = Paginator (objects，3) 

# 输出 全 部 数据 ， 即 整个 数据 列表 

>>> p.object list 

dg eh te da 3 ed | 
# 获取 数据 列表 的 长 度 

>>> p.count 

10 

# 分 页 后 的 总 页 数 


>>> p.num pages 


4 

# 将 页 数 转换 成 range 循环 对 象 

>>> p.page_range 

range (1l, 5) 

# 获取 第 二 页 的 数据 信息 

>>> page2 = p.page (2) 

# 判断 第 二 页 是 否 存在 上 一 页 

>>> page2.has_previous () 

True 

# 如 果 当 前 页 数 存在 上 一 页 ， 就 输出 上 一 页 的 页 数 ， 否 则 抛 出 EmptyPage 异常 


>>> page2.previous page number() 


于 

# 判断 第 二 页 是 否 存在 下 一 页 

>>> page2. has next() 

True 

# 如 果 当 前 页 数 存在 下 一 页 ， 就 输出 下 一 页 的 页 数 ， 否 则 抛 出 EmptyPage 异常 


>>> page2.next page number() 


1 

# 输出 第 二 页 所 对 应 的 数据 内 容 

>>> page2.object list 

['d', 'e', 'f£'] 

# 输出 第 二 页 的 第 一 条 数据 在 整个 数据 列表 的 位 置 ， 数 据 位 置 从 1 开始 计算 


>>> page2.start index() 


4 

# 输出 第 二 页 的 最 后 一 条 数据 在 整个 数据 列表 的 位 置 ， 数 据 位 置 从 1 开始 计算 
>>> page2 .end index() 

6 


上 述 代码 是 Django 分 页 功能 的 使 用 方法 ,根据 对 象 类 型 可 以 将 代码 分 为 两 部 分 : 
分 页 对 象 p 和 某 分 页 对 象 page2， 两 者 说 明 如 下 。 
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(1) 分 页 对 象 p: 由 模块 Paginator 实例 化 生成 。 在 Paginator 实例 化 时 ， 需 要 传 
入 参数 object 和 per_page， 参 数 object 是 待 分 页 的 数据 对 象 ， 参 数 per_page 用 于 设置 
每 页 的 数据 量 。 对 象 p 提供 表 10-3 所 示 的 函数 。 


表 10-3 对 象 p 提 供 的 函数 








函数 说 明 

object list 输出 被 分 页 的 全 部 数据 ， 即 数据 列表 objects 

Count 获取 当前 被 分 页 的 数据 总 量 ， 即 数据 列表 objects 的 长 度 
num pages 获取 分 页 后 的 总 页 数 











page_range 将 总 页 数 转换 成 range 循 环 对 象 
page(number) 获取 某 一 页 的 数据 对 象 ， 参 数 number 代 表 页 数 








(2) 某 分 页 对 象 page2: 由 对 象 p 使 用 函数 page 所 生成 的 对 象 。page2 提供 表 
10-4 所 示 的 函数 。 


表 10-4 对 象 page 2 提供 的 函数 
淹 断 当 前 页 数 是 下 存在 上 二 


如 果 当 前 页 数 丰 在 上 一 页 ， 输出 上 一 页 的 页 数 ， 否 则 抛 出 
一 EmptyPage 异 常 











判断 当前 页 数 是 否 存在 下 一 页 
如 果 当 前 页 数 存在 下 一 页 ， 输 出 下 一 页 的 页 数 ， 和 否则 抛 出 

next_ page_number() EmptyPage 异 党 
object list 输出 当前 分 页 的 数据 信息 

. 输出 当前 分 页 的 第 一 条 数据 在 整个 数据 列表 的 位 置 ， 数 据 位 置 
start_index() 以 1 开始 计算 

. 输出 当前 分 页 的 最 后 一 条 数据 在 整个 数据 列表 的 位 置 ， 数 据 位 
Pm 置 以 1 开始 计算 。 





我 们 通过 一 个 示例 来 讲述 如 何在 开发 过 程 中 使 用 Django 内 置 分 页 功能 。 在 
MyDjango 的 数据 库 中 分 别 对 数据 表 index_type 和 index_product 添加 数据 信息 ， 数 据 
来 源 于 第 6 章 ， 可 以 在 本 书 源码 中 找到 数据 文件 ， 如 图 10-18 所 示 。 
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图 10-18 左边 是 数据 表 index_product， 右 边 是 数据 表 index_type 


然后 在 index 中 添加 模板 pagination.html， 模 板 的 样式 文件 common.css 和 


pagination.css 存放 在 index 的 静态 文件 夹 static 中 ， 如 图 10-19 所 示 。 





~ MyDjango Eon 
v baindex 
》 ba migrations 
Y Bn static 
Y Dcss 


总 cartscss 
s ndexcss 











10-19 MyDjango 目录 结构 


完成 项 目的 环境 搭建 后 ， 本 示例 的 分 页 功能 需要 由 index 的 urlspy、views.py 和 
pagination.html 共同 实现 ， 首 先 在 urls py 和 views.py 中 分 别 添加 以 下 代码 : 


# urls.py 
from django.urls import path 
from . import views 


urlpatterns = [ 
# 首页 
path('', views.index, name='index'), 
# 购物 车 


path('shoppingCar.html', views.ShoppingCarView, name="'ShoppingCar'), 


# 分 页 功能 
path ('pagination/<int:page>.html', views.paginationView, 
name='pagination'), 


] 
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# views.py 的 paginationView 函数 
# 分 页 功能 
# 导入 paginator 模块 
from django .core-paginator import Paginator, EmptyPage, PageNotAnInteger 
def paginationView (request, page): 
# 获取 数据 表 index_product 的 全 部 数据 
Product list = Product.objects.all() 
# 设置 每 一 页 的 数据 量 为 3 
paginator = Paginator (Product list, 3) 
try: 
pageInfo = paginator.page (page) 
except PageNotAnInteger: 
# 如 果 参 数 page 的 数据 类 型 不 是 整 型 ， 就 返回 第 一 页 数据 
pageInfo = paginator.page (1) 
except EmptyPage: 
# 车 用 户 访问 的 页 数 大 于 实际 页 数 ， 则 返回 最 后 一 页 的 数据 
pageInfo = paginator.page (paginator.num pages) 
return render (request， 'pagination.html', locals()) 


上 述 代 码 设 置 了 分 页 功能 的 URL 地 址 和 相应 的 视图 函数 ， 其 说 明 如 下 : 


。 URL 地 址 设置 了 动态 变量 page， 该 变量 代表 用 户 当 前 访问 的 页 数 。 

。 ”函数 paginationView 首先 获取 数据 表 index_product 中 的 全 部 数据 ， 生 成 变量 
Product list。 

。 通过 分 页 模块 paginator 对 变量 Product list 进 行 分 页 , 以 每 3 条 数据 划分 为 一 页 。 

e 使 用 函数 page 获取 分 页 对 象 paginator 中 某 一 分 页 的 数据 信息 。 

@ 当 变 量 page 传 入 函数 page 时， 如 果 变 量 page 不 是 整 型 ， 程 序 就 会 抛 出 
PageNotAnJInteger 异常 ， 然 后 返回 第 一 页 的 数据 。 


@ 如 果 变 量 page 的 数值 大 于 总 页 数 ， 程 序 就 会 抛 出 EmptyPage 异常 ， 然 后 
返回 最 后 一 页 的 数据 。 异 常 PageNotAnInteger 和 EmptyPage 都 来 自 于 模块 


paginator。 


将 视图 函数 处 理 的 结果 传 给 模板 文件 pagination.html， 然 后 把 分 页 后 的 数据 展示 
在 网 页 中 。 模 板 文件 pagination.html 的 代码 如 下 : 

<!1DOCTYPE html> 

<html lang="en"> 


<head> 
<meta charset="UTF-8"> 
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<title> 分 页 功能 </title> 
{# 导入 css 样式 文件 #} 
{$$ load staticfiles $%} 
<link type="text/css" rel="stylesheet" href="{% static "css/common. 
CSSs" $}"> 
<link type="text/css" rel="stylesheet" href="{% static "css/ 
pagination.css" $}"> 
</head> 
<body> 
<div class="wrapper clearfix" id="wrapper"> 
<div class="mod songlist"> 
<ul class="songlist header"> 
<li class="songlist header_name"> 产 品名 称 </1i> 
<li class="songlist header author"> 重量 </1i> 
<1li class="songlist header album"> 尺 寸 </1i> 
<li class="songlist_header_other"> 产品 类 型 </1i> 
</ul> 
<ul class="songlist list"> 
{# 列 出 当前 分 页 所 对 应 的 数据 内 容 #} 
{% for item in pageInfo $%} 
<1li class="js_songlist_ child" mid="1425301" ix="6"> 
<div class="songlist item"> 
<div class="songlist songname">{{item.name}}</div> 
<div class=" ‘onglist artist">{{item.weight}}</div> 
<div class="songlist album">{{item.size}}</div> 
<div class="songlist other">{{ item.type }}</div> 
</div> 
</1i> 
{% endfor %} 
</ul> 
{# 分 页 导航 #} 
<div class="page-box"> 
<div class="pagebar" id="pageBar"> 
{# 上 一 页 的 URL 地 址 #} 
{% if pageInfo.has previous %} 
<a href="{%url 'pagination' pageInfo.previous page number®}" 
class="prev"><i></i> 上 一 页 </a> 
{% endif %} 
{# 列 出 所 有 的 URL 地 址 #} 
{% for num in pageInfo.paginator.page range $%} 
{% if num == pageInfo.number %} 
<span class="sel">{{ pageInfo.number }}</span> 
{% else %} 
<a href="{% url'pagination'num %}"target=" self">{{num}}</a> 
{$$ endif %} 
{$$ endfor $®} 
{# 下 一 页 的 URL 地 址 #} 
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{% if pageInfo.has next %} 
<a href="{% Url "pagination' pagelInfo.next page number $%}" 
class="next"> 下 一 页 <i></i></a> 
{% endif %} 
</div> 
</div> 
</div><!--end mod songlist--> 
</div><!--end wrapper--> 
</body> 
</html> 


完成 urlspy、viewspy 和 pagination html 的 代码 编写 后 ， 最 后 测试 功能 是 否 正常 
运行 。 启 动 项 目 并 在 浏览 器 上 访问 http://127.0.0.1:8000/pagination/1.html， 单 击 分 页 
导航 时 ， 程 序 会 自动 跳 转 到 相应 的 URL 地 址 并 返回 对 应 的 数据 信息 ， 运 行 结果 如 图 
10-20 所 示 。 
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图 10-20 运行 结果 


10.6 本 章 小 结 





Django 为 开发 者 提供 了 常见 的 Web 应 用 程序 , 如 会 话 控制 、 高 速 缓存 .CSRF 防护 、 
消息 提示 和 分 页 功能 。 内 置 的 Web 应 用 程序 大 大 优化 了 网 站 性 能 ， 并 且 完 善 了 安全 
防护 机 制 ， 而 且 也 提高 了 开发 者 的 开发 效率 。 

Django 内 置 的 会 话 控制 简称 为 Session， 可 为 访问 者 提供 基础 的 数据 存储 。 数 据 
主要 存储 在 服务 器 上 ， 并 且 网 站 的 任意 站 点 都 能 使 用 会 话 数据 。 当 用 户 第 一 次 访问 网 
站 时 ， 网 站 的 服务 器 将 自动 创建 一 个 Session 对 象 ， 该 Session 对 象 相 当 于 该 用 户 在 
站 的 一 个 身份 赁 证， 而 且 Session 能 存储 该 用 户 的 数据 信息 。 当 用 户 在 网 站 的 页 
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间 跳 转 时 ， 存 储 在 Session 对 象 中 的 数据 不 会 丢失 ， 只 有 Session 过 期 或 被 清理 时 ， 服 
务 器 才 将 Session 中 存储 的 数据 清空 并 终止 该 Session。 


Django 提供 5 种 不 同 的 缓存 方式 ， 每 种 缓存 方式 说 明 如 下 。 


Memcached: 一 个 高 性 能 的 分 布 式 内 存 对 象 缓存 系统 ， 用 于 动态 网 站 ， 以 减 
轻 数据 库 负 载 。 通 过 在 内 存 中 缓存 数据 和 对 象 来 减少 读 取 数 据 库 的 次 数 ， 从 
而 提高 网 站 的 响应 速度 。 使 用 Memcached 需要 安装 系统 服务 器 ，Django 通过 
python-memcached 或 pylibme 模块 调用 Memcached 系统 服务 器 ， 实 现 缓存 读 
写 操作 ， 适 合 超大 型 网 站 使 用 。 

数据 库 缓 存 : 缓存 信息 存储 在 网 站 数据 库 的 缓存 表 中 ， 缓 存 表 可 以 在 项 目的 
配置 文件 中 配置 ， 适 合 大 中 型 网 站 使 用 。 

文件 系统 缓存 : 缓存 信息 以 文本 文件 格式 保存 ， 适 合 中 小 型 网 站 使 用 。 

本 地 内 存 缓存 : Django 默认 的 缓存 保存 方式 ， 将 缓存 存放 在 项 目 所 在 系统 的 
内 存 中 ， 只 适用 于 项 目 开发 测试 。 

虚拟 缓存 : Django 内 置 的 虚拟 缓存 ， 实 际 上 只 提供 缓存 接口 ， 并 不 能 存储 缓 
存 数据 ， 只 适用 于 项 目 开发 测试 。 


Django 为 了 防护 这 类 攻击 ， 在 用 户 提 交 表 单 时 ， 表 单 会 自动 加 入 csrftoken 的 隐 
含 值 ， 这 个 隐 含 值 会 与 网 站 后 台 保存 的 csrftoken 进行 匹配 ， 只 有 匹配 成 功 ， 网 站 才 会 
处 理 表单 数据 。 这 种 防护 机 制 称 为 CSRF 防护 ， 原 理 如 下 : 


在 用 户 访 问 网 站 时 ，Diango 在 网 页 的 表单 中 生成 一 个 隐 含 字段 csrftoken， 这 
个 值 是 在 服务 器 端 随机 生成 的 。 

当 用 户 提交 表单 时 ， 服 务 器 校 验 表 单 的 csrftoken 是 否 和 自己 保存 的 csrftoken 
一 致 ， 用 来 判断 当前 请 求 是 否 合法 。 

如 果 用 户 被 CSRF 攻击 并 从 其 他 地 方 发 送 攻击 请 求 ， 由 于 其 他 地 方 不 可 能 知 
道 隐藏 的 csrftoken 信息 ， 因 此 导致 网 站 后 台 校 验 csrftoken 失败 ， 攻 击 就 被 成 
功 防御 。 


Django 中 的 消息 提示 必须 依赖 中 间 件 SessionMiddleware， 因 为 消息 提示 的 引擎 
默认 是 SessionStorage， 而 SessionStorage 是 在 Session 的 基础 上 实现 的 。 消 息 提示 共 
有 5 种 类 型 ， 类 型 说 明 下 。 
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消息 提示 的 5 种 类 型 
类 型 说 明 
提示 开发 过 程 中 的 相关 调试 信息 
提示 信息 ， 如 用 户 信 息 
SUCCESS 提示 当前 操作 执行 成 功 
WARNING 警告 当前 操作 存在 风险 
ERROR 提示 当前 操作 错误 





Django 分 页 功能 由 模块 Paginator 实现 ， 开 发 者 可 以 调用 模块 Paginator 所 提供 的 
函数 实现 网 站 的 分 页 功能 ， 函 数 说 明 如 下 。 











模块 Paginator 所 提供 的 函数 
函数 说 明 
输出 被 分 页 的 全 部 数据 ， 即 数据 列表 objects 
获取 当前 被 分 页 的 数据 总 量 ， 即 数据 列表 objects 的 长 度 
获取 分 页 后 的 总 页 数 
将 总 页 数 转换 成 range 循 环 对 象 。 
获取 某 一 页 的 数据 对 象 ， 参 数 number 代 表 页 数 。 
判断 当前 页 数 是 否 存在 上 一 页 。 
如 果 当 前 页 数 存在 上 一 页 ， 输 出 上 一 页 的 页 数 ， 否 则 抛 出 
Previous_page_numberO EmptyPage 异 常 。 
判断 当前 页 数 是 否 存在 下 一 页 。 
各 果 当 前 机 数 在 下 一 页， 输出 下 一 页 的 页 数 ， 否 则 抛 出 
object list 输出 当前 分 页 的 数据 信息 。 
ea 输出 当前 分 页 的 第 一 条 数据 在 整个 妆 据 列表 的 位 置 数据 位 置 
i 输出 当前 分 页 的 最 后 一 条 数据 在 整个 数据 列表 的 位 置 ， 数 据 位 
置 以 1 开始 计算 。 
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本 章 以 音乐 网 站 项 目 为 例 ， 介 绍 Django 在 实际 项 目 开发 中 的 应 用 ， 该 网 站 共 分 
为 6 个 功能 模块 ， 分 别 是: 网 站 首页 、 歌 曲 排行 榜 、 歌 曲 播放 、 歌 曲 点 评 、 歌 曲 搜索 
和 用 户 管理 。 


11.1 网 站 需求 与 设计 


当 我 们 接 到 一 个 项 目的 时 候 ， 首 先 需要 了 解 项 目的 具体 需求 ， 根 据 需 求 类 型 划分 
网 站 功能 , 并 了 解 每 个 需求 的 业务 流程 。 本 节 以 音乐 网 站 为 例 进行 介绍 ， 整 个 网 站 的 
功能 分 为 : 网 站 首页 、 歌 曲 排行 榜 、 歌 曲 播放 、 歌 曲 搜索 、 歌 曲 点 评 和 用 户 管理 ， 各 
个 功能 说 明 如 下 : 





日 ”网 站 首页 是 整个 网 站 的 主 界面 ， 主 要 显示 网 站 最 新 的 动态 信息 以 及 网 站 的 功 
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能 导航 。 网 站 动态 信息 以 歌曲 的 动态 为 主 ， 如 热门 下 载 、 热 门 搜索 和 新 歌 推 
荐 等 ; 网 站 的 功能 导航 是 将 其 他 页 面 的 链接 展示 在 首页 上 , 方便 用 户 访问 浏览 。 

e 歌曲 排行 榜 是 按照 歌曲 的 播放 量 进行 排序 ， 用 户 还 可 以 根据 歌曲 类 型 进行 自 
定义 筛选 。 

@ 歌曲 播放 是 为 用 户 提供 在 线 试 听 功 能 ， 此 外 还 提供 歌曲 下 载 、 歌 曲 点 评 和 相 
关 歌 曲 推荐 。 

e@ 歌曲 点 评 是 通过 歌曲 播放 页 面 进入 的 ， 每 条 点 评 信息 包含 用 户 名 、 点 评 内 容 
和 点 评 时 间 。 

e@ 歌曲 搜索 是 根据 用 户 提供 的 关键 字 进 行 歌曲 或 歌手 匹配 查询 的 ， 搜 索 结果 以 
数据 列表 显示 在 网 页 上 。 

e 用户 管理 分 为 用 户 注册 、 登 录 和 用 户 中 心 。 用 户 中 心包 含 用 户 信息 、 登 录 注 
销 和 歌曲 播放 记录 。 














我 们 根据 需求 对 网 站 的 开发 进行 设计 ， 首 先 由 UI 设计 师 根据 网 站 需求 实现 网 页 
设计 图 ， 然 后 由 前 端 工程 师 根据 网 页 设计 图 实现 HTML 静态 页 面 ， 最 后 由 后 端 工程 
师 根据 HIML 静态 页 面 实现 数据 库 构建 和 网 站 后 台 开 发 。 根 据 上 述 网 站 需求 ， 一 共 
设计 了 6 个 网 站 页 面 ， 其 中 网 站 首页 如 图 11-1 所 示 。 















































从 网 站 首页 的 设计 图 可 以 看 到 ， 按 照 网 站 功能 可 以 分 为 7 个 功能 区 ， 说 明 如 下 。 
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e@ 歌曲 搜索 : 位 于 网 页 顶端 ， 由 文本 输入 框 和 搜索 按钮 组 成 ， 文 本 输入 框 下 面 
是 热门 搜索 的 歌曲 。 

。 轮 播 图 : 以 歌曲 的 封面 进行 轮 播 ， 单 击 图 片 可 进入 歌曲 播放 。 

。 音乐 分 类 : 位 于 轮 播 图 的 左边 ， 按 照 歌 曲 的 类 型 进行 分 类 。 

日 ”热门 歌曲 : 位 于 轮 播 图 的 右边 ， 按 照 歌 曲 的 播放 量 进行 排序 。 

日 “新歌 推荐 : 按照 歌曲 的 发 行 时 间 进 行 排序 。 

@ 热门 搜索 : 按照 歌曲 的 搜索 量 进行 排序 。 

e ”热门 下 载 : 按照 歌曲 的 下 载 量 进行 排序 。 


歌曲 排行 榜 页 面 如 图 11-2 所 示 。 
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图 11-2 歌曲 排行 榜 


从 歌曲 排行 榜 的 设计 图 可 以 看 到 ， 整 个 页 面 分 为 两 部 分 : 歌曲 分 类 和 歌曲 列表 ， 
说 明 如 下 。 





。 歌曲 分 类 : 根据 歌曲 类 型 进行 歌曲 筛选 ， 筛 选 后 的 歌曲 显示 在 歌曲 列表 中 。 
。 歌曲 列表 : 歌曲 信息 以 播放 次 数 进行 降序 显示 ， 若 对 歌曲 进行 类 型 第 选 ， 则 
对 同一 类 型 的 歌曲 以 播放 次 数 进行 降序 显示 。 

















歌曲 播放 页 面 如 图 11-3 所 示 。 
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图 11-3 歌曲 播放 
从 歌曲 播放 的 设计 图 可 以 看 到 ， 整 个 页 面 共有 4 大 功能 : 各 个 功能 说 明 如 下 。 





。 歌曲 信息 包括 歌 名 、 歌 手 、 所 属 专辑 、 语 种 、 流 派 、 发 行 时 间 、 歌 词 、 歌 
曲 封面 和 歌曲 文件 等 。 


e 下 载 与 歌曲 点 评 : 实现 歌曲 下 载 , 每 下 载 一 次 都 会 对 歌曲 的 下 载 次 数 累 加 一 次 。 
单 击 “ 歌 曲 点 评 ” 可 进入 歌曲 点 评 页 面 。 


e@ 播放 列表 : 记录 当前 用 户 的 试听 记录 ， 每 播放 一 次 都 会 对 歌曲 的 播放 次 数 累 
加 一 次 。 


。 相关 歌曲 : 根据 当前 歌曲 的 类 型 第 选 出 同一 类 型 的 其 他 歌曲 信息 。 


如 图 11-4 所 示 。 
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图 11-4 歌曲 点 评 





198 























第 11 章 音乐 网 站 开发 











歌曲 点 评 主要 分 为 两 部 分 : 歌曲 点 评 和 点 评 信息 列表 ， 两 者 说 明 如 下 。 
































。 歌曲 点 评 ， 由 文本 输入 框 和 发 表 按钮 组 成 的 表单 ， 以 POST 的 请 求 形式 实现 
内 容 提交 。 
。 点 评 信息 列表 : 列 出 当前 歌曲 的 点 评 信息 ， 并 对 点 评 信息 设置 分 页 功能 。 











歌曲 搜索 页 面 如 图 11-5 所 示 。 
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图 11-5 歌曲 搜索 











歌曲 搜索 主要 根据 文本 框 的 内 容 对 歌 名 或 歌手 进行 匹配 查询 ， 然 后 将 搜索 结果 返 
到 搜索 页 面 上 ， 其 说 明 如 下 : 





。 车 文本 框 的 内 容 为 空 ， 则 默认 返回 前 50 首 最 新 发 行 的 歌曲 。 
e 车 文本 框 的 内 容 不 为 空 ， 则 从 歌曲 的 歌 名 或 歌手 进行 匹配 查询 ， 查 询 结 果 以 


歌曲 的 发 行 时 间 进 行 排序 。 
e 每 次 搜索 时 ， 若 文本 框 的 内 容 与 歌 名 完全 相符 ， 则 相符 的 歌曲 将 其 搜索 次 数 
累加 一 次 。 





用 户 中 心 页 面 如 图 11-6 所 示 。 
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售 我 的 音乐 











图 11-6 用 户 中 心 


用 户 中 心 需要 用 户 登录 后 才能 访问 ， 该 页 面 主 要 分 为 用 户 基 本 信息 和 歌 





记录 ， 说 明 如 下 。 











播放 











用 户 基 本 信息 : 显示 当前 用 户 的 用 户头 像 和 用 户 名 , 并 设 有 用 户 退 出 登录 链接 。 


e@ 歌曲 播放 记录 : 播放 记录 来 自 于 歌曲 播放 页 面 的 播放 列表 ， 并 对 播放 记录 进 


行 分 页 显示 。 





用 户 注 册 和 登录 页 面 如 图 11-7 所 示 。 
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图 11-7 用 户 注 册 和 登录 
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用 户 的 注册 和 登录 是 由 同一 个 页 面 实现 两 个 不 同 的 功能 ， 注 册 与 登录 都 是 通过 
JavaScript 脚本 来 控制 显示 的 ， 其 说 明 如 下 。 


日 “用户 注册 : 填写 用 户 名 、 手 机 号 和 用 户 密码 ， 其 中 用 户 名 和 手机 号 码 具有 唯 
一 性 ， 而 且 不 能 为 空 。 
日 ”用 户 登 录 : 根据 用 户 注册 时 所 填写 的 手机 号 码 或 用 户 名 实现 用 户 登 录 。 


11.2 数据 库 设计 


从 网 站 的 需求 与 网 站 设计 可 以 得 知 , 歌曲 信息 是 整个 网 站 最 为 核心 的 数据 。 因 此 ， 
设置 网 站 的 数据 结构 时 ， 应 以 歌曲 信息 为 核心 数据 ， 逐步 向 外 扩展 相关 联 的 数据 信息 。 
我 们 将 歌曲 信息 的 数据 表 命名 为 song， 歌 曲 信息 表 song 的 数据 结构 如 表 11-1 所 示 。 


表 11-1 歌曲 信息 表 song 的 数据 结构 





Varchar 类 型 ， 长 度 为 20 歌曲 的 语种 
Varchar 类 型 ， 长 度 为 20 歌曲 的 风格 类 型 
Varchar 类 型 ， 长 度 为 20 歌曲 的 发 行 时 间 


song img Varchar 类 型 ， 长 度 为 20 歌曲 封面 图 片 路 径 
song lyrics Varchar 类 型 ， 长 度 为 50 歌曲 的 歌词 文件 路 径 
song file Varchar 类 型 ， 长 度 为 50 歌曲 的 文件 路 径 

label id Int 类 型 ， 长 度 为 11 外 键 ， 关 联 歌曲 分 类 表 














从 表 11-1 可 以 看 到 ， 歌 曲 信 息 表 song 的 字段 以 Varchar 类 型 定义 ， 数 据 表 记 录 
了 歌曲 的 基本 信息 ， 如 歌 名 、 歌 手 、 时 长 、 所 属 专辑 、 语 种 、 流 派 、 发 行 时 间 、 歌 词 、 
歌曲 封面 和 歌曲 文件 ， 其 中 歌曲 封面 、 歌 词 和 歌曲 文件 是 以 路 径 的 形式 记录 在 数据 库 
中 的 。 一 般 来 说 ， 如 果 网 站 中 涉及 文件 的 使 有 用， 数据库 最 好 记录 文件 的 访问 路 径 。 若 
将 文件 的 内 容 直接 写 入 数据 库 中 ， 则 会 对 数据 库 造 成 一 定 的 压力 ， 从 而 降低 网 站 的 响 
应 速度 。 
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在 歌曲 信息 表 song 的 字段 label id 可 以 知道 ， 歌 曲 信息 表 song 关联 歌曲 分 类 表 ， 
我 们 将 歌曲 分 类 表 命 名 为 label， 和 歌曲 分 类 表 主 要 实现 网 站 首页 的 音乐 分 类 ， 其 数据 
结构 如 表 11-2 所 示 。 
表 11-2 歌曲 分 类 表 的 数据 结构 
表 字段 | 字段 类 型 含义 | 








label id Int 类 型 ， 长 度 为 11 主键 





Varchar 类 型 ， 长 度 为 10 ”| 歌曲 的 分 类 标签 


在 网 站 需求 中 ， 还 会 涉及 歌曲 动态 信息 ， 因 此 延伸 出 歌曲 动态 表 。 歌 曲 动 态 表 
用 于 记录 歌曲 的 播放 次 数 、 搜 索 次 数 和 下 载 次 数 ， 并 且 与 歌曲 信息 表 song 实现 一 对 
一 的 数据 关系 ， 也 就 是 一 首 歌曲 只 有 一 条 动态 信息 。 将 歌曲 动态 表 命 名 为 dynamic， 
其 数据 结构 如 表 11-3 所 示 。 


表 11-3 歌曲 动态 表 的 数据 结构 


最 后 还 有 与 歌曲 信息 表 song 相互 关联 的 歌曲 点 评 表 ， 该 表 主 要 用 于 歌曲 点 评 页 
面 。 从 歌曲 点 评 页 面 可 以 知道 ， 一 首 歌 可 以 有 多 条 点 评 信息 ， 说 明 歌 曲 信息 表 song 
和 歌曲 点 评 表 存在 一 对 多 的 数据 关系 。 将 歌曲 点 评 表 命名 为 comment， 其 数据 结构 如 
表 11-4 所 示 。 





表 11-4 歌曲 点 评 表 的 数据 结构 











comment user Varchar 类 型 ， 长 度 为 20 用 户 名 
comment date Varchar 类 型 ， 长 度 为 50 点 评 日 期 
song id Int 类 型 ， 长 度 为 11 外 键 ， 关 联 歌曲 信息 表 
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至 此 ， 我 们 以 歌曲 信息 表 song 为 核心 数据 表 ， 从 而 延伸 出 歌曲 分 类 表 label、 歌 
曲 动态 表 dynamic 和 歌曲 点 评 表 comment。4 张 数 据 表 的 表 结 构 以 及 表 关 系 如 图 11-8 






























































所 示 。 
BH song_ id. int dynamic_plays 

song_nane dynamic_search int 
Song_singer dmanie_dom int 
song_time song_id int 

comment_id song_slbun 

comment_texi song languages 20) 

comment_user song_type 

conmnent_date: varc song releas 

song_id int song_ing 


song lyrios 
song file » 
label_id int 




















11-8 数据 表 结 构 以 及 表 关系 








除 此 之 外 ， 还 有 网 站 的 用 户 管理 功能 ， 用 户 管理 功能 由 用 户 表 myuser 提供 用 户 
信息 。 用 户 表 myuser 由 Django 内 置 模型 User 扩展 而 成 ， 其 数据 结构 如 表 11-5 所 示 。 


表 11-5 用 户 表 的 数据 结构 


[ER Ts ia | 
IE 
TI 




















ET 
Varchar 类 型 ， 长 度 为 30 ， 户 的 名 字 

last_name Varchar 类 型 ， 长 度 为 150 用 户 的 
Varchar 类 型 ， 长 度 为 254 

is_staff Tinyint 类 型 ， 长 度 为 1 录 Admin 权 限 

is_active Tinyint 类 型 ， 长 度 为 1 用 户 的 激活 状态 

date joined Datetime 类 型 ， 长 度 为 6 用 户 创建 的 时 间 

Qd Varchar 类 型 ， 长 度 为 20 用 户 的 QQ 号 码 

weChat Varchar 类 型 ， 长 度 为 20 用 户 的 微 信号 码 

Mobile Varchar 类 型 ， 长 度 为 11 用 户 的 手机 号 码 
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11.3 项 目 创建 与 配置 


我 们 对 音乐 网 站 的 需求 与 设计 有 了 大 概 的 了 解 ， 下 一 步 将 需求 与 设计 落实 到 
真正 开发 中 。 我 们 选择 Python 3.5 或 以 上 版 本 + Django 2.0 或 以 上 版 本 + MySQL + 
PyCharm 作为 网 站 的 开发 工具 ， 开 发 环境 是 Windows 操作 系统 。 

首先 在 CMD 窗口 下 创建 Django 项 目 ， 项 目 命名 为 music， 然 后 在 项 目 music 中 
分 别 创建 项 目 应 用 index、ranking、play、comment、search 和 user， 创 建 指令 如 下 : 


因 因 因 因 四 四 四 音 四 悍 





startapp ranking 


startapp comment 
startapp search 


创建 music 项 目 

:\>django-admin startproject music 

创建 项 目 应 用 index、ranking、play、comment、search 和 user 
:\>cd music 

:\music>python manage.py startapp index 
:\music>python manage.py 

:\music>python manage.py startapp play 

:\music>python manage.py 

:\music>python manage.py 

:\music>python manage.py startapp user 


完成 项 目 和 项 目 应 用 的 创建 后 ， 我 们 在 项 目 music 的 根 目录 下 创建 文件 夹 
templates 和 static， 两 者 分 别 存放 模板 文件 和 静态 资源 文件 。 然 后 在 文件 夹 templates 
中 放置 公用 模板 title_base.html， 而 在 文件 夹 static 目录 下 创建 文件 夹 css、js、font、 
image、songFile、songLyric 和 songImg 以 及 放置 图 片 favicon.ico， 文 件 夹 static 的 目 
录 说 明 如 下 : 
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css 是 存放 全 网 站 的 CSS 样式 的 文件 。 
js 是 存放 全 网 站 的 JS 脚本 的 文件 。 
font 是 存放 网 站 字体 的 文件 。 

image 是 存放 网 站 页 面 的 图 片 。 
songFile 是 存放 歌曲 的 文件 。 
songLyric 是 存放 歌词 的 文件 。 
songImg 是 存放 歌曲 封面 的 文件 。 
favicon ico 是 网 站 LOGO 图 片 。 
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项 目 music 的 目录 结构 是 根据 网 站 的 需求 与 设计 进行 搭建 的 ， 不 同 的 需求 与 设计 
都 会 导致 项 目的 目录 结构 有 所 不 同 。 我 们 打开 PyCharm 查看 项 目 music 的 目录 结构 ， 
如 图 11-9 所 示 。 





v Bmusic E\music 
> Bcomment 

> Paindex 

> 加 music 

> 加 play 

> Branking 

> Ba search 

> BP static 

> 四 templates 

> Buser 








六 manage.py 
11-9 项 目 目录 结构 





项 目 目录 结构 搭建 完成 后 ， 下 一 步 是 对 项 目 进行 相关 的 配置 ， 配 置信 息 主要 
在 配置 文件 settings.py 中 完成 。 我 们 对 项 目 music 的 属性 INSTALLED APPS、 
MIDDLEWARE、TEMPLATES 和 DATABASES 进行 相关 配置 ， 配 置信 息 如 下 : 


# 添加 新 增 的 项 目 应 用 index、ranking、play、comment、search 和 user 
INSTALLED APPS = [ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.statictfiles', 
'index', 
'ranking', 
'user', 
'play', 
'search', 
'comment', 


] 


# 添加 中 间 件 LocaleMiddleware 

MIDDLEWARE = [ 
'django.middleware.security.SecurityMiddleware', 
'django.contrib.sessions.middleware.SessionMiddleware', 
# 使 用 中 文 


'django.middleware.locale.LocaleMiddleware', 
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"django -middleware .common -CommonMiddleware'yv 
'django.middleware.csrf.CsrfViewMiddleware', 
'django.contrib.auth.middleware.AuthenticationMiddleware', 
'django.contrib.messages.middleware.MessageMiddleware', 
'django.middleware.clickjacking.XFrameOptionsMiddleware', 


# 设置 模板 路 径 ， 在 每 个 App 中 分 别 创建 模板 文件 夹 emplates 
TEMPLATES = [ 
{ 
'BACKEND': 'django.template.backends.django.DjangoTemplates', 
'DIRS': [os.path.join(BASE DIR, 'templates'), 
os.path.join(BASE DIR, ' index/templates'), 
os.path.join(BASE DIR, 'ranking/templates'), 
os.path.join (BASE _ DIR, 'user/templates'), 
os.path.join (BASE DIR, 'play/templates'), 
os.path.join(BASE DIR, ' comment/templates'), 
], 
'APP_DIRS': True, 
"OPTIONS': { 
'context processors': [ 
'django.template.context processors.debug', 
'django.template.context processors.request', 
'django.contrib.auth.context processors.auth', 
'django.contrib.messages.context processors.messages', 


}, 


# 设置 数据 库 连 接 信 息 ， 项 目 使 用 的 数据 库 为 music_db 
DATABASES = { 
'default': { 

'ENGINE': 'django.db.backends.mysqgl', 

'NAME': 'music db', 

"USER": "root”s 

'PASSWORD' : '1234', 

"HOSY': "127.0.05 1 

"PORT':'3306', 


} 


任何 一 个 项 目 都 需要 对 配置 属性 INSTALLED APPS、MIDDLEWARE、 
TEMPLATES 和 DATABASES 进行 配置 ,这 是 一 个 项 目的 常规 配置 。 完 成 项 目 配置 后 ， 
我 们 接着 对 项 目的 URL 进行 配置 。 在 项 目的 urls.py 中 分 别 对 新 建 的 App 设置 相应 的 
URL 地 址 ， 设 置 如 下 : 
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from django.contrib import admin 

from django .urls import path, include 

# 配置 URL 地 址 信息 

urlpatterns = [ 
path('admin/', admin.site.urls), 
path('', include('index.urls')), 
path('ranking.html', include('ranking.urls')), 
path('play/', include('play-.urls')), 
path('comment/', include('comment.urls')), 
path('search/', include('search.urls')), 
path('user/', include('user.urls')), 


] 


至 此 ， 音 乐 网 站 的 开发 环境 基本 上 已 搭建 完毕 。 在 整个 项 目 搭建 过 程 中 ， 我 们 
总 结 出 Django 开发 环境 的 搭建 流程 ， 其 说 明 如 下 : 

。 创建 Django 项 目 ， 可 以 在 CMD 窗口 下 输入 创建 指令 或 者 在 PyCharm 下 实现 
项 目 新 建 。 

ee 创建 项 目的 App 应 用 ， 创 建 方式 也 是 在 CMD 窗口 或 者 PyCharm 下 实现 。 

e@ ”在 项 目的 根 目 录 下 新 建文 件 夹 templates 和 static, 分 别 存 放 模 板 文件 和 静态 资源 。 

e 设置 项 目的 配置 信息 ， 由 settings.py 实现 ， 常 规 的 配置 属性 有 INSTALLED_ 
APPS、 MIDDLEWARE、 TEMPLATES 和 DATABASES。 

e@ ”根据 项 目的 App 或 者 项 目的 页 面 来 设 定 网 站 的 URL 地 址 信息 ， 由 项 目的 urls. 
py 实现 。 


11.4 网 站 首页 


网 站 首页 是 整个 网 站 的 主 界面 ， 从 网 站 的 需求 设计 来 看 ， 首 页 共 实 现 7 个 功能 : 
歌曲 搜索 、 轮 播 图 、 音 乐 分 类 、 热 门 歌曲 、 新 歌 推 荐 、 热 门 搜索 和 热门 下 载 。 在 项 目 
music 中 ， 首 页 由 项 目 应 用 index 实现 ， 我 们 在 index 中 创建 模板 文件 夹 templates， 
在 文件 夹 中 放置 模板 文件 index.html， 如 图 11-10 所 示 。 
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v Bindex 
> 加 migrations 
v Btemplates 
天 indexhtml 

访 _init_.py 
访 admin.py 
访 apps.py 
前 models.py 
刘 tests.py 
访 urls.py 
六 views.py 


图 11-10 index 目录 结构 























首页 的 歌曲 信息 应 该 来 自 于 数据 库 ， 除 了 Django 内 置 的 数据 表 之 外 ， 根 据 项 目 
的 数据 库 设 计 得 知 ， 网 站 一 共 定义 了 4 张 数据 表 ， 为 了 方便 管理 ， 我 们 将 4 张 数据 表 
所 对 应 的 模型 都 在 index 的 models.py 中 进行 定义 ， 模 型 定义 如 下 : 


# index 的 models.py 
from django.db import models 


# 歌曲 分 类 表 label 
class Label (models.Model): 
label_id = models.AutoField(' 序 号 ',， primary_key=True) 
label name = models.CharField(' 分 类 标签 '， max_ length=10) 
def _str (self): 
return self.label name 
class Meta: 
# 设置 Admin 界面 的 显示 内 容 
verbose_name = ' 歌曲 分 类 
Verbose_name_plural = ' 歌曲 分 类 


# 歌曲 信息 表 song 

class Song (models.Model): 
song_id = models.AutoField(' 序 号 ',， primary_key=True) 
song name = models.CharField(" 歌 名 '， max length=50) 
song_singer = models.CharField(' 歌手 '， max_ length=50) 
song time = models.CharField("' 时 长 '， max length=10) 
song album = models.CharField(" 专辑 '， max_ length=50) 
song languages = models.CharField(' 语种 '， max length=20) 
song type = models.CharField("' 类 型 '， max length=20) 
song_ release = models.CharField(" 发 行 时 间 '， max length=20) 
song img = models.CharField!(" 歌曲 图 片 '， max length=20) 
song lyrics = models.CharField(" 歌词 '， max length=50, default=" 暂 无 歌 

词 ') 
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song file = models.CharField(" 歌曲 文件 '， max length=50) 
label = models.ForeignKey (Label, on delete=models.CASCADE,verbose 
name=' 歌 名 分 类 ' ) 
def _str (self): 
return self.song name 
class Meta: 
# 设置 Admin 界面 的 显示 内 容 
verbose_name = ' 歌曲 信息 ' 
verbose_name plural = ' 歌曲 信息 ' 


# 歌曲 动态 表 dynamic 
class Dynamic (models.Model): 
dynamic id = models.AutoField(' 序 号 ',， primary key=True) 
song = models.ForeignKey (Song, on delete=models.CASCADE, verbose_ 
name=' 歌 名 ') 
dynamic plays = models.IntegerField(' 播放 次 数 ') 
dynamic_ search = models.IntegerField(' 搜索 次 数 ') 
dynamic_down = models.IntegerField(' 下 载 次 数 ') 
class Meta: 
# 设置 Admin 界面 的 显示 内 容 
verbose_name = ' 歌曲 动态 ' 
verbose_name_plural = ' 歌曲 动态 ' 


# 歌曲 点 评 表 comment 
class Comment (models.Model): 
comment_id = models.AutoField(' 序 号 ',， primary_key=True) 
comment_ text = models.CharField(' 内 容 ',，max_ length=500) 
comment_user = models.CharField(' 用 户 ', max_length=20) 
song = models.ForeignKey (Song, on delete=models.CASCADE,verbose_ 
name=' 歌 名 ') 
comment_date = models.CharField(" 日 期 max_length=50) 
class Meta: 
# 设置 Admin 界面 的 显示 内 容 
verbose_name = ' 歌曲 评论 ' 
verbose_name_plural = ' 歌曲 评论 ' 


上 述 代码 定义 了 模型 Label、Song、Dynamic 和 Comment， 分 别 对 应 歌曲 分 类 表 
label、 和 歌曲 信息 表 song、 歌 曲 动态 表 dynamic 和 歌曲 点 评 表 comment。 我 们 根据 模型 
的 定义 在 项 目的 数据 库 中 创建 相应 的 数据 表 ， 在 PyCharm 的 Terminal 模式 下 输入 数 
据 迁 移 指令 : 


# 根据 models .py 的 内 容 生成 相关 的 .py 文件 ， 该 文件 用 于 创建 数据 表 
E:\music>python manage.py makemigrations 
Migrations for '‘'index': 

index\migrations\0001 initial.py 
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- Create model Comment 

— Create model Dynamic 

- Create model Label 

- Create model Song 

— Rdd field song to dynamic 

=- Rdd field song to comment 
# 创建 数据 表 


E:\music>python manage.py migrate 


我 们 打开 数据 库 music_db 可 以 看 到 项 目 所 有 已 定义 的 模型 都 能 转换 成 相应 的 数 
据 表 ， 在 数据 表 index label、index_song 和 index dynamic 中 分 别 添 加 网 站 开发 所 需 
的 数据 信息 ， 如 图 11-11 和 图 11-12 所 示 。 


于 v 天 二 外 二 -本 RE 丘 WF 四 SA 下 5d 

好 a 事务 国 备注 " 可 伟 迁 竺 排序 臣 SA dynamicjd dramic plays 。 dymamicseardh dynamic down 。 song 
- ES 

labelid label_ name 


0 加 
甘 1 条 记录 ( 共 13 条 ) 于 第 1 页 


songtime song_album songlanguages song_bpe song_release songimg song_yrics 
04:20 贡 要 夏 国志 2010-12-08 ”1jpg 。。 辕 天 于 司 
《前 任 3 : 再 见 前 国生 2017-12-25 ”2jpg 。 看 天 歌 司 
Fighting ! 生存 之 国 要 2006-04-15 百 无 歌 河 
2009-05-29 车 无 瑟 词 
2009-11-20 特 无 歌 司 
2017-12-07 ER 
2012-03-19 7 车 天 二 局 
2015-06-05 8j 芹 无 了 司 
2006-10-01 四 
2006-07-05 芹 无 六 词 
2015-07-24 11 Tibet 
2016-10-10 
2016-09-07 


EE 全 是 恒 - 是 是 是 是- 是 
让 路 注 如 友 中 器 钞 器 如 明光 中 


v 
we1* 忆 心 | 国 回 
第 1 短 B 录 纵 13 入 于 第 1 页 





11-12 数据 表 index_song 
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值得 注意 的 是 ， 数 据 表 index_song 的 字段 song img、song lyrics 和 song file 的 
数据 分 别 代表 静态 文件 夹 songImg、songLyric 和 songFile 里 面 的 文件 名 。 在 实际 的 开 
发 中 ， 文 件 的 存储 都 是 采用 文件 服务 器 存放 的 ， 比 如 阿里 云 的 云 存 储 OSS 和 腾讯 云 
的 对 象 存储 COS 等 。 

至 此 ， 网 站 的 数据 模型 和 数据 表 的 数据 已 经 部 署 完毕 ， 下 一 步 是 实现 网 站 首页 的 
开发 。 网 站 首页 主要 由 index 的 路 由 配置 urls py、 视 图 views.py 和 模板 index.html 共 
同 实现 ， 代 码 如 下 : 


# index 的 urls.py 
from django.urls import path 
from . import views 
# 设置 首页 的 URL 地 址 信息 
urlpatterns = [ 
path('', views.indexView, name='index'), 


] 


# index 的 views.py 
from django.shortcuts import render 
from .models import * 
def indexView (request): 
# 热 搜 歌曲 
search song = Dynamic.objects.select related('song') .order by('- 
dynamic search') .all() [:8] 
# 音乐 分 类 
label list = Label.objects.all() 
# 热门 歌曲 
Play_hot_song = Dynamic.objects.select related('song') .order by('- 
dynamic plays').all()[:10] 
# 新 歌 推 荐 
daily recommendation = Song.objects.order by('-song release') .all() 
[:3] 
# 热门 搜索 、 热 门下 载 
search ranking = search_song[:6] 
down ranking = Dynamic.objects.select related('song') .order by('- 
dynamic down') .all()[:6] 
all ranking = [search ranking, down ranking] 
return render (equest， 'index.html',locals()) 


上 述 代码 将 首页 的 响应 处 理 交 给 视图 函数 indexViews 执行 ， 并 且 将 首页 的 URL 
命名 为 mdex，URL 的 命名 可 以 在 模板 上 使 用 Django 内 置 的 url 标签 生成 相应 的 URL 
地 址 。 视 图 函数 indexViews 一 共 执行 了 5 次 数据 查询 ， 其 说 明 如 下 。 
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esearch song: 通过 歌曲 的 搜索 次 数 进 行 降序 查询 ， 由 Django 内 置 的 select_ 
related 方法 实现 模型 Song 和 Dynamic 的 数据 查询 。 

e ”label list: 查询 模型 Label 的 全 部 数据 ， 数 据 显示 在 首页 轮 播 图 左 侧 的 音乐 分 
类 中 。 

eplay hot song: 由 select related 方法 实现 模型 Song 和 Dynamic 的 数据 查询 ， 
查询 结果 以 歌曲 的 播放 次 数 进 行 降序 排列 ， 数 据 显 示 在 首页 轮 播 图 右 侧 的 热 


门 歌曲 中 。 
edaily recommendation: 以 歌曲 发 行 时 间 的 先后 顺序 查询 前 三 首 歌 曲 的 信息 ， 
数据 显示 在 首页 的 新 歌 推荐 中 。 


。 all ranking: 由 热门 搜索 和 热门 下 载 组 成 的 列表 。 热 门 搜索 的 数据 来 自 于 
search_song; 热门 下 载 用 于 获取 下 载 次 数 排 在 前 6 行 的 歌曲 信息 。 


最 后 在 模板 index.html 中 编写 模板 语法 ， 将 视图 函数 indexViews 查询 所 得 的 数据 
对 象 通过 遍历 的 方式 呈现 在 网 页 上 。 由 于 模板 index.html 的 代码 较 多 ， 此 处 只 列 出 首 
页 的 功能 代码 , 完整 的 模板 代码 可 在 下 载 资源 中 查看 。 模 板 index.html 的 功能 代码 如 下 : 


# 模板 index .html 的 功能 代码 
# 首页 的 搜索 框 ， 由 HTML 表单 实现 ，{% url 'search' XXX %} 是 搜索 页 面 的 地 址 链接 
<form id="searchForm" action="{% url 'search' 1 %}" method="post" 
target=" blank"> 
{% Csrf token %} 
<div class="search-keyword"> 
<input name="kword" type="text" class="keyword" maxlength="120" 
placeholder=" 音乐 节 " /> 
</div> 
<input id="subSerch" type="submit" class="search-button" value=" 搜 索 " /> 
</form> 
# 搜索 框 下 面 的 热门 搜索 歌曲 ，{% url 'play' XXX %} 是 播放 页 面 的 地 址 链接 
<div id="suggest" class="search-suggest"></div> 
<div class="search-hot-words"> 
{% for song in search song %} 
<a target="play" href="{% url 'play' song.song.song id %}" >{{ song. 
song.song name }}</a> 
{% endfor %$} 
</div> 


# 网 站 导航 栏 

<ul class="nav clearfix"> 

<1i><a href="/"> 首 页 </a></1i> 

<li><a href="{% url 'ranking' $%}"” target=" blank"> 歌曲 排行 </a></1i> 
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<li><a href="{% url 'home' 1 $}" target=" blank"> 用 户 中 心 </a></1i> 
</ul> 


# 音乐 分 类 ， 位 于 轮 播 图 的 左 侧 
<div class="category-nav-body"> 
<div id="J CategoryItems" class="category-items"> 
{% for label in label list %} 
<div class="item" data-index="1"><h3> 
<a href="javascript:;">{{ label.label name }}</a></h3> 
</div> 
{% endfor %} 
</div> 
</div> 


{% url 'play' 12 %} 是 播放 页 面 的 地 址 链接 
|_FocusSlider" class="focus"> 
<div id="bannerLeftBtn" class="banner btn"></div> 
<ul class="focus-list f _w"> 
<li class="f _s"><a target="play" href="{% url 'play' 12 %}" 
class="layz _ load" > 
<img data-src="{% static '/image/datu-1.jpg' %}" width="750" 
height="275"></a> 
</1i> 
<li class="f_s"><a target="play" href="{% url 'play' 13 %}" 
class="layz_ load" > 
<img data-src="{% static '/image/datu-2.jpg' %}" width="750" 
height="275"></a> 
</1i> 
</ul> 
<div id="bannerRightBtn" class="banner btn"></div> 
</div> 





# 热门 歌曲 ， 位 于 轮 播 图 的 右 侧 。{{ forloop.counter }} 用 于 显示 当前 循环 次 数 
<div class="aside"> 
<h2> 热门 歌曲 </h2> 
<ul> 
{% for song in play hot song %} 
<li><span>{{ forloop.counter }}</span> 
<a target="play" href="{% Url "play' song.song.song id %}" >{{ song. 
song.song name }}</a> 
</1i> 
{$$ endfor $} 
</ul> 
</div> 


# 新 歌 推 荐 


<div id="J TodayRec" class="today-list"> 
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<ul> 
{% for list in daily recommendation %} 
{% if forloop.first %} 

<li class="first"> 


{$s else $} 
<14> 
{% endif %} 


<a class="pic layz load pic po" target="play" href="{% url 'play' list. 
song id %}" > 
<img data-src="{% static "songImg/" %}{{ list.song img }}" ></a> 
<div class="name"> 
<h3><a target="play" href="{% url "play' list.song id %}" >{{ list. 
song name }}</a></h3> 
<div class="singer"><span>{{ list.song singer }}</span></div> 
<div class="times"> 发 行 时间 : <span>{{ list.song _ release }}</span></div> 
</div> 
<a target="play" href="{% url 'play' list.song id %}" class="today-buy- 
button"” > 去 听 听 ></a> 
{% endfor %} 
</ul> 
</div> 


# 热门 搜索 和 热门 下 载 
<div id="J Tab Con" class="tab-container-cell"> 
{% for list in all ranking %} 
{% if forloop.first %} 

<ul class="product-list clearfix t s current"> 
{% else $%} 

<ul class="product-list clearfix t_ s" style="display:none;"> 
{% endif %} 
# 嵌 套 循环 
{% for songs in list %} 
<1i> 

<a target="play" href="{%url "Play' songs.song.song id%}" class="pic 

layz_load pic po"> 
<img data-src="{% static "songImg/" %}{{ songs.song.song img 





}}" ></a> 

<h3> 

<a target="play" href="{%url "play' songs.song.song id%}">{{songs. 
song.song name}}</a> 


</h3> 
<div class="singer"><span>{{ songs.song.song singer }}</span></div> 
{% if all rankinglfirst == list %} 
<div class="times"> 搜索 次 数 : <span>{{ songs.dynamic search }}</ 
span></div> 


{$% else $%} 
<div class="times"> 下 载 次 数 : <span>{{ songs.dynamic down }}</ 


214 











第 11 章 音乐 网 站 开发 





span></div> 
{$$ endif %} 
</1i> 
{$$ endfor $} 
</ul> 
{$$ endfor $} 
</div> 


从 模板 的 功能 代码 可 以 看 到 ， 每 个 功能 都 是 通过 遍历 的 方式 将 视图 函数 传递 的 
变量 进行 输出 ， 还 有 部 分 功能 在 数据 列举 的 过 程 中 ， 通 过 判断 当前 循环 次 数 来 控制 
HTML 标签 的 样式 。 为 了 检验 首页 是 否 正常 运行 ， 启 动 music 项 目 ， 在 浏览 器 上 访问 
http:/127.0.0.1:8000/， 运 行 结果 如 图 11-13 所 示 。 









































图 11-13 网 站 首页 


11.5 歌曲 排行 榜 

















歌曲 排行 榜 是 通过 首页 的 导航 链接 进入 的 ， 按 照 歌曲 的 播放 次 数 进 行 降序 显示 。 
从 排行 榜 页 面 的 设计 图 可 以 看 到 ， 网 页 实现 三 个 功能 ， 网 页 顶部 搜索 、 歌 曲 分 类 筛选 
和 歌曲 信息 列表 ， 其 说 明 如 下 。 
页 顶部 搜索 : 每 个 网 页 都 具备 的 基本 功能 ， 而 且 每 个 网 页 的 实现 方式 和 原理 
是 相同 的 。 
分 类 筛选 ， 根据 歌曲 信息 表 song 的 song type 字段 对 歌曲 进行 筛选 ， 并 显 
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示 在 网 页 左 侧 的 歌曲 分 类 中 。 

歌曲 信息 列表 : 在 网 页 上 显示 播放 次 数 排 在 前 10 条 的 歌曲 信息 。 

歌曲 排行 榜 是 由 项 目 music 的 项 目 应 用 ranking 实现 的 ， 我 们 在 ranking 目录 下 创 
建 模板 文件 夹 templates 并 且 在 文件 夹 中 放置 模板 文件 ranking html， 如 图 11-14 所 示 。 





















































v Branking 
> 各 migrations 
Y Btemplates 
起 ranking.html 

总 _init_py 
访 admin.py 
访 apps.py 
访 models.py 
意 tests.py 
访 urls.py 
六 viewspy 


11-14 ranking 目录 结构 











歌曲 排行 榜 是 由 ranking 的 urlspy、views.py 和 ranking.html 实现 的 。 在 ranking 
的 urls.py 中 设置 歌曲 排行 榜 的 URL 地 址 信息 ， 并 在 views.py 中 编写 相应 的 URL 处 
理 函 数 ， 其 代码 如 下 : 














# ranking 的 urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
path('', views.rankingView, name='ranking'), 


] 


# ranking 的 views.py 
Erom django . shortcuts import render 
from index.models import * 
def rankingView (request): 
# 热 搜 歌曲 
search song = Dynamic.objects.select related('song') .order by('— 
dynamic search') .all()[:4] 
# 歌曲 分 类 列表 
All list = Song.objects.values('song type') .distinct () 
# 歌曲 列表 信息 


song type = request.GET.get('type', '') 


























if song type: 
song info = Dynamic.objects.select related('song') .filter(song _ 
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song_ type=song type) - 
order by('-dynamic plays')-all() [:10] 
elses 
song info = Dynamic.objects.select related('song') .order by('-— 
dynamic plays') .all()[:10] 
return render(request, 'ranking.html', locals()) 


上 述 代码 将 歌曲 排行 榜 的 响应 处 理 交 给 视图 函数 rankingView 执行 ， 并 且 将 URL 
命名 为 ranking。 视 图 函数 rankingView 一 共 执 行 了 三 次 数据 查询 ， 其 说 明 如 下 。 


e@ search song: 通过 歌曲 的 搜索 次 数 进行 降序 查询 ， 由 Django 内 置 的 select_ 
related 方法 实现 模型 Song 和 Dynamic 的 数据 查询 。 

e ”All list; 对 模型 Song 的 字段 song_ type 进行 去 重 查询 。 

。 ”song_info: 根据 用 户 的 GET 请 求 参数 进行 数据 查询 。 若 请 求 参数 为 空 ， 则 对 
全 部 歌曲 进行 第 选 ， 获 取 播 放 次 数 排 在 前 10 位 的 歌曲 ; 若 请 求 参数 不 为 空 ， 
则 根据 参数 内 容 进行 歌曲 筛选 ， 获 取 播 放 次 数 排 在 前 10 位 的 歌曲 。 


根据 视图 函数 rankingView 所 生成 的 变量 ， 我 们 在 模板 ranking.html 中 编写 相关 
的 模板 语法 ， 由 于 模板 ranking.html 的 代码 较 多 ， 此 处 只 列 出 相关 的 功能 代码 ， 完 整 
的 模板 代码 可 在 下 载 资源 中 查看 。 模 板 ranking.html 的 功能 代码 如 下 : 


# 模板 index.html 的 功能 代码 

# 排行 榜 的 搜索 框 ， 由 HTML 表单 实现 ，{% url 'search' XXX %} 是 搜索 页 面 的 地 址 链接 

<form id="searchForm" action="{% url 'search' 1 $%}" method="post" 
target=" blank"> 

{% Csrf token %} 

<div class="search-keyword"> 

<input name="kword" type="text" class="keyword" maxlength="120" 

placeholder=" 音乐 节 " /> 

</div> 

<input id="subSerch" type="submit" class="search-button" value=" 搜 索 " 
加 

</form> 

# 搜索 框 下 面 的 热门 搜索 歌曲 ，{% url 'play' XXX %} 是 播放 页 面 的 地 址 链接 

<div id="suggest" class="search-suggest"></div> 

<div class="search-hot-words"> 

{% for song in search song %} 

<a target="play" href="{% url 'play' song.song.song id %}" >{{ song. 

song.song name }}</a> 

{$% endfor $%} 

</div> 
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# 网 站 导航 栏 

<ul class="nav clearfix"> 

<li><a href="/"> 首 页 </a></1i> 

<li><a href="{% url 'ranking' $%}"” target=" blank"> 歌曲 排行 </a></1i> 
<li><a href="{% url 'home' 1 $}" target=" blank"> 用户 中 心 </a></1i> 
</ul> 


# 歌曲 分 类 列表 
<div class="side-nav"> 
<div class="nav-head"> 
<a href="{% url 'ranking' %}"> 所 有 歌曲 分 类 </a> 
</div> 
<ul id="sideNav" class="cate-item"> 
{% for item in All list %} 
<li class="computer"> 
<div class="main-cate"> 
# 构建 URL 并 设置 请 求 参数 
<a href="{% url "Iranking' %}?type={{ item.song type }}" 
class="main-title">{{ item.song type }}</a> 
</div> 
</1i> 
{% endfor %} 
</ul> 
</div> 


# 歌曲 列表 信息 

<table class="rank-list-table"> 

E> 
<th class="cell-1"> 排 名 </th> 
<th class="cel1-2"> 图片 </th> 
<th class="cel1-3"> 歌 名 </th> 
<th class="cel1-4"> 专辑 </th> 
<th class="cel1-5"> 下载 量 </th> 
<th class="cel1-6"> 播放 量 </th> 

</tr> 

{% for item in song info %} 

<tr> 
{$$ if forloop.counter < 4 %} 
<td><span class="nl">{{ forloop.counter }}</span></td> 


{Selse %} 
<td><span class="n2">{{ forloop.counter }}</span></td> 
{Sendif $%} 
<td> 
<a href="{% url "play' item.song.song id %}" class="picn 


target="play"> 
<img src="{% static "songImg/"%}{{item.song.song img}}" 
width="80" height="80"></a> 
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</td> 
<td class="name-cell"> 
<h3><a href="{% url 'play' item.song.song id %}" 
target="play" >{{ item.song.song name }}</a></h3> 
<div class="desc"> 
<a href="javascript:;" target=" blank" class="type" >{{item. 
song.song singer}}</a> 
</div> 
</td> 
<td> 
<div style="text-align:center;">{{ item.song.song album }}</ 
div> 
</td> 
<td> 


<div style="text-align:center;">{{ item.dynamic down }}</div> 
</td> 


<td class="num-cell">{{ item.dynamic plays }}1</td> 
</tr> 


{% endfor %} 
</table> 


从 上 述 代码 可 以 看 到 ， 模 板 将 视图 函数 传递 的 变量 进行 遍历 输出 ， 从 而 生成 相应 
的 HTML 网 页 内 容 ， 模 板 代码 编写 逻辑 与 首页 的 模板 是 相同 的 原理 。 为 了 检验 网 页 


是 否 正 常 显示 ， 启 动 music 项 目 ， 在 浏览 器 上 访问 http://127.0.0.1:8000/ranking.html， 
运行 结果 如 图 11-15 所 示 。 
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图 11-15 歌曲 排行 榜 





























在 上 述 实 现 过 程 中 ，URL 的 处 理 方式 是 由 视图 函数 rankingView 完成 的 ， 而 视图 
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函数 rankingView 主要 实现 数据 查询 并 将 查询 结果 传递 给 模板 ， 因 此 ， 我 们 还 可 以 使 
用 通用 视图 来 完成 URL 处 理 。 使 用 通用 视图 实现 视图 函数 rankingView 的 功能 ， 只 
需 在 ranking 的 urls.py 和 views.py 中 编写 相关 代码 即 可 实现 ， 代 码 如 下 : 


# ranking 的 urls.py 

from django.urls import path 

from . import views 

urlpatterns = [ 
path('', views.rankingView, name='ranking'), 
# 通用 视图 


path('.list', views.RankingList.as view(), name='rankingList'), 


# ranking 的 views.py 

# 通用 视图 

from django.views.generic import ListView 
from index.models import * 

class RankingList (ListView): 


# context_object_name 设置 HTML 模板 的 某 一 个 变量 名 称 


context object name = 'song info' 
# 设 定 模板 文件 
template name = 'ranking.html' 


# 查询 变量 song_info 的 数据 
def get queryset (self): 
# 获取 请 求 参 数 
song_ type = self.request.GET.get('type', '') 
if song type: 
song_info = Dynamic.objects.select related('song'). 
filter(song song type=song type). 
order by('-dynamic plays') .all()[:10] 
else: 
song_info = Dynamic.objects.select related('song'). 
order by('-dynamic plays') .all()[:10] 
return song_info 
# 添加 其 他 变量 
def get context datal(self, **kwargs): 
Context = super() .get context data(**kwargs) 


# 搜索 歌曲 
context['search song'] = Dynamic.objects.select related('song'). 
order by('-dynamic search'). 
all()[:4] 
# 所 有 歌曲 分 类 


context['All list'] = Song.objects.values('song type') .distinct () 
return context 


上 述 代码 中 ， 我 们 在 ranking 的 urlspy 中 设置 通用 视图 的 URL 地 址 信息 ， 
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命 名 为 
RankingL’ 








最 后 由 模板 ranking.html 处 理 变量 并 生成 HIML 网 页 。 重 启 项 目 ， 在 浏览 器 上 访问 
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IankingList，URL 的 处 理 由 viewspy 的 RankingList 执 行 。 通 用 视图 
ist 也 是 实现 三 次 数据 查询 ， 数 据 查询 与 视图 函数 rankingView 是 相同 的 ， 






































http://127.0.0.1:8000/ranking.html.list， 运 行 结果 如 图 11-15 所 示 。 


11.6 歌曲 播放 













































































在 前 面 的 章节 中 ， 网 站 首页 和 歌曲 排行 榜 以 数据 查询 为 主 ， 本 节 主 要 实现 歌曲 在 
线 试听 和 歌曲 下 载 功能 ， 这 也 是 整个 网 站 的 核心 功能 之 一 。 从 网 站 的 设计 图 可 以 看 到 ， 
歌曲 播放 页 面 主要 实现 的 功能 有 : 网 页 顶部 搜索 、 歌 曲 的 基本 信息 、 当 前 播放 列表 、 
歌曲 点 评 下 载 和 相关 歌曲 推荐 ， 功 能 说 明 如 下 。 
。 网 页 顶部 搜索 ,每 个 网 页 具有 的 基本 功能 ， 而 且 每 个 网 页 的 实现 方式 和 原理 
是 相同 的 。 

e。 歌曲 的 基本 信息 ; 显示 当前 播放 歌曲 的 基本 信息 ， 如 歌 名 、 歌 手 、 专 辑 、 歌 
曲 封面 和 歌词 等 。 

ee ”当前 播放 列表 : 记录 用 户 的 试听 记录 ， 并 且 可 以 对 当前 播放 的 歌曲 进行 切换 。 

。 歌曲 点 评 下 载 : 主要 实现 歌曲 的 点 评 和 下 载 功 能 。 歌 曲 点 评 通过 地 址 链接 进 
入 歌曲 点 评 页 面 ， 歌 曲 下 载 用 于 实现 文件 的 下 载 功能 。 

e@ 相关 歌曲 推荐 , 根据 当前 播放 歌曲 的 类 型 进行 第 选 ， 筛 选 结果 以 歌曲 的 播放 
次 数 进行 排序 ， 获 取 前 6 首 歌曲 信息 ， 显 示 在 网 页 的 最 下 方 。 

歌曲 播放 是 由 项 目 music 的 play 实现 的 。 在 play 的 目录 下 创建 模板 文件 夹 

templates 并 且 在 文件 夹 中 放置 模板 文件 play.html， 如 图 11-16 所 示 。 
v Bplay 
> Bamigrations 
v Btemplates 
是 playhtml 
访 _init_.py 
篇 adminpy 
隅 appspy 
访 models.py 
前 testspy 
也 udqspy 
全 viewspy 

















图 11-16 play 目录 结构 
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我 们 在 play 的 urlspy、viewspy 和 playhtml 中 编写 相关 的 功能 代码 ， 实 现 歌 曲 
的 播放 与 下 载 功能 。 首 先 在 urlspy 中 设置 歌曲 播放 和 歌曲 下 载 的 URL 地 址 信息 ， 并 
在 views.py 中 编写 相应 的 URL 处 理 函 数 ， 其 代码 如 下 : 


# play 的 urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
# 歌曲 播放 页 面 
path('<int:song id>.html', views.playView, name='play'), 
# 歌曲 下 载 
path('download/<int:song id>.html',views.downloadView, 
name='download') 


] 


# play 的 views.py 
from django.shortcuts import render 
from django.http import StreamingHttpResponse 
from index.models import * 
# 歌曲 播放 页 面 
def playView (request, song id): 
# 热 搜 歌曲 
search song = Dynamic.objects.select related('song') .order by('- 
dynamic search') .all() [:6] 
# 歌曲 信息 
song_info = Song.objects.get (song id=int (song id)) 
# 播放 列表 
play_ list = request.session.get('play list', []) 
song exist = False 
if play list: 
for i in play list: 


if int(song id) == i['song id']: 
song exist = True 
if song exist == False: 


play_list.append({'song id': int(song id), 'song singer': song_ 
info.song singer, 
'song name': song info.song name, 'song_ 


time': song info.song time}) 
request.session['play list'] = Play list 
# 歌词 
if song info.song lyrics != " 暂 无 歌词 ' : 


f = open('static/songLyric/' +song info.song lyrics, 'r', 
encoding="'utf-8') 
song lyrics = f.read() 
f.close() 
# 相关 歌曲 
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song _ type = Song.objects.values('song _ type') .get (song id=song id) 
["song_type'] 
song relevant = Dynamic-objects-select _ related('song') .filter(song 
song_ type=song _ type) - 
order by('-dynamic plays').all()[:6] 
# 添加 播放 次 数 
# 扩展 功能 : 可 使 用 session 实现 每 天 只 添加 一 次 播放 次 数 
dynamic _ info = Dynamic.objects .filter (song_idq=int(song id)) .first() 
# 判断 歌曲 动态 信息 是 否 存在 ， 存 在 就 在 原来 的 基础 上 加 1 
if dynamic info: 
dynamic info.dynamic plays += 1 
dynamic info.save() 
# 车 动态 信息 不 存在 ， 则 创建 新 的 动态 信息 
else: 
dynamic info = Dynamic(dynamic plays=1, dynamic search=0, 
dynamic down=0, song id=song id) 
dynamic info.save() 
return render(request, 'play.html', locals()) 


# 歌曲 下 载 
def downloadView (request, song id): 
# 根据 song_id 查找 歌曲 信息 
song_info = Song.objects.get (song id=int(song_id)) 
# 添加 下 载 次 数 
dynamic info = Dynamic.objects .filter(song id=int (song id)) .first() 
# 判断 歌曲 动态 信息 是 否 存在 ， 存 在 就 在 原来 的 基础 上 加 1 
if dynamic info: 
dynamic info.dynamic down += 1 
dynamic info.save() 
# 若 动态 信息 不 存在 ， 则 创建 新 的 动态 信息 
else: 
dynamic info = Dynamic (dynamic plays=0,dynamic search=0,dynamic_ 
down=1, song_id=song id) 
dynamic info.save() 
# 读 取 文件 内 容 
file = 'static/songFile/' + song info.song file 
def file iterator (file, chunk size=512): 
with open (file, 'rb') as f: 
while True: 
c= f.read(chunk size) 
if£f Cc: 
Yield c 
else: 
break 
# 将 文件 内 容 写 入 StreamingHttpResponse 对 象 ， 并 以 字 节 流 的 方式 返回 给 用 户 ， 实 现 文 
件 下 载 


filename = str(song id) + '.mp3' 
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response = StreamingHttpResponse (file iterator (file)) 
response['Content-Type'] = "application/octet-stream’' 
response['Content-Disposition'] = "attachment filename="%s"™"" 


$ (filename) 
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return response 


从 上 述 代 码 可 以 看 到 ，play 的 urls.py 中 设 有 两 个 URL 地 址 ， 分 别 命名 为 play 和 
download。 具 体 说 明 如 下 : 


命名 为 play 的 URL 代表 歌曲 播放 页 面 的 地 址 ， 并 设 有 参数 song id; 参数 
song id 是 当前 的 歌曲 在 歌曲 信息 表 song 中 的 主键 ， 视 图 函数 通过 URL 的 参 
数 来 获取 歌曲 的 信息 。 

命名 为 download 的 URL 用 于 实现 歌曲 的 下 载 功能 。 在 歌曲 播放 页 面 可 以 看 
到 “下 载 ” 按钮 ， 该 按钮 是 一 个 URL 地 址 链接 ， 当 用 户 单 击 “ 下 载 ” 按 钮 时 ， 
网 站 触发 一 个 GET 请 求 ， 该 请 求 指向 命名 为 download 的 URL， 由 视图 函数 
downloadView 处 理 并 做 出 响应 。 


由 于 urlspy 设 有 两 个 URL 地址 ， 因 此 URL 对 应 的 视图 函数 分 别 是 playView 和 
downloadView。 首 先 讲述 视图 函数 playView 实现 的 功能 ， 视 图 函数 playView 分 别 实 
现 4 次 数据 查询 、 播 放 列 表 的 设置 、 歌 词 的 读 取 和 播放 次 数 的 累加 。 


search_song: 获取 热门 搜索 的 歌曲 信息 ， 数 据 查 询 在 前 面 的 章节 已 讲述 过 ， 
此 处 不 再 重复 讲述 。 

song_info: 根据 URL 提供 的 参数 song id 在 歌曲 信息 表 song 中 查询 当前 歌曲 
的 信息 。 

play_list， 获 取 当 前 Session 的 play_ list 信息 ，play list 代表 用 户 的 播放 记录 。 
将 URL 的 参数 song id 与 play_list 的 song id 进行 对 比 ， 如 果 两 者 匹配 得 上 ， 
说 明 当 前 歌曲 已 加 入 播放 记录 ; 如 果 匹 配 不 上 ， 将 当前 的 歌曲 信息 加 入 play_ 
list。 

song_lyrics: 当前 歌曲 的 歌词 内 容 。 首 先 判 断 当前 歌曲 是 否 存 在 歌词 文件 ， 如 
果 存 在 ， 就 读 取 歌词 文件 的 内 容 并 赋值 给 变量 song_lyrics。 

song relevant: 根据 URL 提供 的 参数 song id 在 歌曲 信息 表 song 中 查询 当前 
歌曲 的 类 型 ， 然 后 根据 歌曲 类 型 查询 同一 类 型 的 歌曲 信息 ， 并 以 歌曲 的 播放 
次 数 进行 排序 。 


歌 
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e@ dynamic info: 根据 URL 提供 的 参数 song id 在 歌曲 动态 表 dynamic 中 查询 当 
前 歌曲 的 动态 信息 。 如 果 不 存在 歌曲 动态 信息 ， 就 新 建 动态 信息 ， 并 且 播 放 
次 数 累加 1; 如果 存 在 歌曲 动态 信息 ， 就 对 原 有 的 播放 次 数 累加 1。 


接着 分 析 视 图 函数 downloadView 实现 的 功能 ， 视 图 函数 downloadView 用 于 实现 


文件 的 下 载 功能 ， 歌 曲 每 下 载 一 次 ， 就 要 对 歌曲 的 下 载 次 数 累加 1。 因此， 视图 


函数 downloadView 主要 实现 两 个 功能 : 歌曲 下 载 次 数 的 累加 和 文件 下 载 ， 功 能 说 明 
如 下 。 


。 dynamic info: 根据 URL 提供 的 参数 song id 在 歌曲 动态 表 dynamic 中 查找 歌 
曲 的 动态 信息 。 如 果 不 存 在 歌曲 动态 信息 ， 就 新 建 动态 信息 ， 并 且 下 载 次 数 
累加 1; 如 果 存 在 歌曲 动态 信息 ， 就 对 原 有 的 下 载 次 数 累 加 1。 

e response: 网 站 的 响应 对 象 ， 由 StreamingHttpResponse 实例 化 生成 。 首 先 以 
字 节 流 的 方式 读 取 歌 曲 文 件 内 容 ， 然 后 将 文件 内 容 写 入 response 对 象 并 设置 
response 的 响应 类 型 ， 从 而 实现 文件 的 下 载 功 能 。 


我 们 根据 视图 函数 playView 和 downloadView 的 响应 内 容 进 行 分 析 ， 函 数 


playView 是 在 浏览 器 上 返回 相关 的 网 页 ， 函 数 downloadView 是 直接 返回 歌曲 文件 供 
用 户 下 载 。 因 此 ， 我 们 对 视图 函数 playView 所 使 用 的 模板 playhtml 进行 代码 编写 。 
由 于 模板 代码 较 多 ， 此 处 只 列举 相关 的 功能 代码 ， 完 整 的 模板 代码 可 在 本 书 提供 的 源 
代码 中 查看 。 代 码 说 明 如 下 : 


# 模板 play .html 的 功能 代码 
# 歌曲 播放 ， 播 放 功 能 由 Javascript 实现 ，Django 只 需 提供 歌曲 文件 即 可 实现 在 线 试听 
<div id="jquery jplayer 1" class="jp-jplayer" 

data-url={% static "songFile/" %}{{ song info.song file }}> 
</div> 


# 歌曲 封面 
<div class="jp img layz_load pic po” title=" 点 击 播放 "> 





<img data-src={% static "songImg/" %}{{ song info.song img }}> 
</div> 


# 歌词 

<textarea id="lrc content" style="display: none;"> 
{{ song lyrics }} 

</textarea> 
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# 歌曲 信息 
<div class="product-price"> 
<hl id="currentSong" >{{ song info.song _ name }}</hl> 
<div class="product-price-info"> 
<span> 歌手 : {{ song info.song singer }}</span> 
</div> 
<div class="product-price-info"> 
<span> 专辑 : {{ song info.song album }}</span> 
<span> 语种 : {{ song_info.song languages }}</span> 
</div> 
<div class="product-price-info"> 
<span> 流派 : {{ song_info.song type }}</span> 
<span> 发 行 时 间 : {{ song_ info.song release } }</span> 
</div> 
</div> 


# 播放 列表 
<ul class="playing-1li" id="songlist"> 
{% for list in play list %} 
# 设置 当前 歌曲 的 样式 
{%if list.song id song_info.song id %} 
<1li data-id="{{list.song id}}" class="current"> 
{Selse %} 
<1li data-id="{{list.song id}}"> 
{Sendif %} 
# 设置 歌曲 列表 的 序号 、 歌 名 和 歌手 
<span class="num">{{ forloop.counter }}</span> 
<a class="name" href="{%url 'play' list.song id%}" 
target="play">{{list.song name}}</a> 
<a class="singer" href="javascript:;" target=" blank" >{{list.song_ 
singer}}</a> 





</1i> 
{Sendfor %} 
</ul> 
# 相关 歌曲 
<ul id="" class="parts-list clearfix f_s"> 
{% for item in song relevant %} 
<1i> 
# 将 当前 歌曲 排除 显示 
{% if item.song.song id != song info.song id %} 


# 设置 歌曲 封面 和 歌曲 播放 链接 


<a class="pic layz load pic po" href="{% url 'play' item.song.song id 





4}" target="play"> 
<img data-src="{% static "songImg/" %}{{ item.song.song img 
WE 
</a> 
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# 设置 歌 名 ， 歌 名 带 播放 链接 


<h4><a href="{% Url 'play' item.song.song id $%}" target="play"> 





{{ item.song.song name }}</a></h4> 
# 设置 歌手 
<a href="javascript:;" class="J MoreParts accessories-more"> 
{{ item.song.song singer }}</a> 
{% endif %} 
</1i> 
{% endfor $} 
</ul> 


从 上 述 代码 可 以 看 到 ， 模 板 playhtml 将 视图 函数 playView 传递 的 变量 进行 遍 
历 输出 ， 从 而 生成 相应 的 HIML 网 页 内 容 。 最 后 检验 功能 是 否 正常 运行 ， 我 们 重新 
启动 music 项 目 ， 在 浏览 器 上 访问 http://127.0.0.1:8000/ranking.html， 运 行 结 果 如 图 
11-17 所 示 。 
































图 11-17 歌曲 播放 页 


11.7 歌曲 点 评 


歌曲 点 评 是 通过 歌曲 播放 页 的 点 评 按钮 而 进入 的 页 面 ， 整 个 网 站 只 能 通过 这 种 方 
式 才能 访问 歌曲 点 评 页 。 歌 曲 点 评 页 主要 实现 两 个 功能 : 歌曲 点 评 和 歌曲 点 评 信息 列 
表 ， 功 能 说 明 如 下 。 







































































日 ”歌曲 点 评 : 主要 为 用 户 提供 歌曲 点 评 功能 ， 以 表单 的 形式 实现 数据 提交 。 
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e@ 歌曲 点 评 信 息 列表 : 根据 URL 的 参数 song id 查找 歌曲 点 评 表 comment 的 相 
关 点 评 内 容 ， 然 后 以 数据 列表 的 方式 显示 在 网 页 上 。 














在 项 目 music 中 ， 歌 曲 点 评 由 comment 实现 。 在 编写 代码 之 前 ， 在 comment 目 
录 下 创建 模板 文件 夹 templates 并 在 文件 夹 中 放置 模板 文件 comment html， 如 图 11-18 
所 示 。 





























Y Bcomment 
> Bn migrations 
v bitemplates 
访 comment.html 

访 _jinit_.py 
访 admin.py 
访 apps.py 
及 models.py 
六 tests.py 
也 urspy 
章 viewspy 


图 11-18 comment 目录 结构 











调整 comment 目录 结构 后 ， 我 们 在 comment 的 urlspy、views.py 和 comment. 
html 中 编写 相关 的 功能 代码 。 首 先 在 urlspy 中 设置 歌曲 点 评 的 URL 地 址 信息 ， 并 在 
views.py 中 编写 URL 的 处 理 函数 ， 其 代码 如 下 : 




















# comment 的 urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
path('<int:song id>.html', views.commentView, name='comment'), 


] 


# comment 的 views.py 
from django.core.paginator import Paginator, EmptyPage, PageNotAnIinteger 
from django.shortcuts import render, redirect 
from django.http import Http404 
from index.models import * 
import time 
def commentView (request, song id) : 
# 搜索 歌曲 
search song = Dynamic.objects.select related('song') .order by('— 
dynamic search') .all()[:6] 
# 点 评 提交 处 理 
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if request -method == 'POST': 
comment text = request.POST.get('comment','') 
comment user = request.user.username if request.user.username 
else ' 匿名 用 户 ' 
if comment text: 
comment = Comment () 
comment.comment text = comment text 
comment .comment user = comment user 
comment .comment date = time.strftime('%Y-%m-%d', time. 
localtime (time.time())) 
comment.song id = song id 
comment .save () 
return redirect('/comment/%s.html' %(str(song id))) 
else: 
song_info = Song.objects.filter (song id=song id) .first() 
# 歌曲 不 存在 ， 抛 出 404 异常 
if not song info: 
raise Http404 
comment all = Comment .objects.filter (song id=song id) .order_ 
by('comment date') 
song_ name = song_info.song name 
page = int(request.GET.get ('page',1)) 
paginator = Paginator (comment all, 2) 
try: 
contacts = paginator.page (page) 
except PageNotAnIinteger: 
contacts = paginator.page (1) 
except EmptyPage: 
contacts = paginator.page (paginator.num pages) 
return render (equest， 'comment.html', locals()) 


从 上 述 代 码 看 到 ，urlspy 的 URL 设置 了 参数 song id， 参 数值 由 歌曲 播放 页 设 
置 ， 我 们 将 URL 命名 为 comment， 响 应 处 理由 视图 函数 commentView 执行 。 视 图 函 
数 commentView 根据 不 同 的 请 求 方式 执行 不 同 的 响应 处 理 ， 具 体 说 明 如 下 : 

当 用 户 从 歌曲 播放 页 进入 歌曲 点 评 页 时 ， 浏 览 器 访问 歌曲 点 评 页 的 URL 相当 于 
向 网 站 发 送 GET 请 求 ， 视 图 函数 commentView 执行 以 下 处 理 : 


e 根据 URL 的 参数 song id 查询 歌曲 信息 表 song， 判 断 歌 曲 是 否 存在 。 如 果 歌 
曲 不 存在 ， 网 站 抛 出 404 错误 信息 。 

@ 如果 歌 曲 存 在 ， 在 歌曲 点 评 表 comment 中 查询 当前 歌曲 的 全 部 点 评 信 息 ， 然 
后 获取 GET 请 求 的 请 求 参 数 page。 参 数 page 代表 点 评 信息 的 分 页 页 数 ， 如 
果 请 求 参数 page 不 存在 ， 默 认 页 数 为 1， 如 果 存 在 ， 将 参数 值 转换 成 Int 类 型 。 
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。 根据 歌曲 的 点 评 信 息 和 页 数 进行 分 页 处 理 ， 将 每 两 条 点 评 信 息 设置 为 一 页 。 


如 果 用 户 在 歌曲 点 评 页 填写 点 评 内 容 并 单 击 “ 发 布 ”按钮 ， 浏 览 器 向 网 站 发 送 
POST 请 求 ，POST 请 求 由 歌曲 点 评 页 的 URL 接收 和 处 理 ， 视 图 函数 commentView 
执行 以 下 处 理 : 


e。 ”首先 获取 表单 里 的 点 评 内容 ， 命 名 为 comment text， 然 后 获取 当前 用 户 名 ， 
如 果 当 前 用 户 没有 登录 网 站 ， 用 户 为 匿名 用 户 ， 用 户 名 为 comment user。 

@ 如 果 comment text 不 为 空 ， 在 歌曲 点 评 表 comment 中 新 增 一 条 点 评 信息 ， 分 
别 记录 点 评 内 容 、 用 户 名 、 点 评 日 期 和 当前 歌曲 在 歌曲 信息 表 的 主键 。 

e。 最 后 以 重 定向 的 方式 跳 回 歌曲 点 评 页 , 网 站 的 重 定 向 可 以 防止 表单 多 次 提交 ， 
解决 同一 条 点 评 信息 重复 创建 的 问题 。 


下 一 步 在 模板 comment.html 中 编写 相应 的 功能 代码 ， 模 板 comment html 实现 5 
个 功能 ， 分 别 是 网 页 的 搜索 框 、 网 站 导航 链接 、 歌 曲 点 评 框 、 点 评 信息 列表 和 列表 
的 分 页 导航 。 其 中 ， 网 页 的 搜索 框 和 网 站 导航 链接 在 前 面 的 章节 已 讲述 过 ， 此 处 不 
再 重复 讲解 。 由 于 模板 comment.html 的 代码 较 多 ， 本 章 只 列 出 歌曲 点 评 框 、 点 评 信 
息 列表 和 列表 的 分 页 导航 的 实现 过 程 ， 具 体 的 代码 可 以 在 本 书 源 代码 中 查看 。 模 板 
comment.html 的 功能 代码 如 下 : 


# 模板 comment .html 的 功能 代码 

# 歌曲 点 评 框 

<div class="comments-box-title"> 我 要 点 评 <<{{ song_name }}>></div> 

<div class="comments-default-score clearfix"></div> 

<form action="" method="post" id="usrform"> 

{% csrf token $%} 

<div class="writebox"> 

<textarea name="comment" form="usrform"></textarea> 

</div> 

<div class="comments-box-button clearfix"> 

<input type="submit"” value=" 发 布 " class=" j cc post entry cc-post-entry" 
id="scoreBtn"> 

<div data-role="user-login" class=" j cc post login"></div> 

</div> 

<div id="scoreTips2" style="padding-top:10px;"></div> 

</form> 


# 显示 当前 分 页 的 歌曲 点 评 信息 ， 生 成 点 评 信息 列表 


<ul class="comment-list"> 
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。 根据 歌曲 的 点 评 信 息 和 页 数 进行 分 页 处 理 ， 将 每 两 条 点 评 信 息 设置 为 一 页 。 


如 果 用 户 在 歌曲 点 评 页 填写 点 评 内 容 并 单 击 “ 发 布 ”按钮 ， 浏 览 器 向 网 站 发 送 
POST 请 求 ，POST 请 求 由 歌曲 点 评 页 的 URL 接收 和 处 理 ， 视 图 函数 commentView 
执行 以 下 处 理 : 


e。 ”首先 获取 表单 里 的 点 评 内容 ， 命 名 为 comment text， 然 后 获取 当前 用 户 名 ， 
如 果 当 前 用 户 没有 登录 网 站 ， 用 户 为 匿名 用 户 ， 用 户 名 为 comment user。 

@ 如 果 comment text 不 为 空 ， 在 歌曲 点 评 表 comment 中 新 增 一 条 点 评 信息 ， 分 
别 记录 点 评 内 容 、 用 户 名 、 点 评 日 期 和 当前 歌曲 在 歌曲 信息 表 的 主键 。 

e。 最 后 以 重 定向 的 方式 跳 回 歌曲 点 评 页 , 网 站 的 重 定 向 可 以 防止 表单 多 次 提交 ， 
解决 同一 条 点 评 信息 重复 创建 的 问题 。 


下 一 步 在 模板 comment.html 中 编写 相应 的 功能 代码 ， 模 板 comment html 实现 5 
个 功能 ， 分 别 是 网 页 的 搜索 框 、 网 站 导航 链接 、 歌 曲 点 评 框 、 点 评 信息 列表 和 列表 
的 分 页 导航 。 其 中 ， 网 页 的 搜索 框 和 网 站 导航 链接 在 前 面 的 章节 已 讲述 过 ， 此 处 不 
再 重复 讲解 。 由 于 模板 comment.html 的 代码 较 多 ， 本 章 只 列 出 歌曲 点 评 框 、 点 评 信 
息 列表 和 列表 的 分 页 导航 的 实现 过 程 ， 具 体 的 代码 可 以 在 本 书 源 代码 中 查看 。 模 板 
comment.html 的 功能 代码 如 下 : 


# 模板 comment .html 的 功能 代码 

# 歌曲 点 评 框 

<div class="comments-box-title"> 我 要 点 评 <<{{ song_name }}>></div> 

<div class="comments-default-score clearfix"></div> 

<form action="" method="post" id="usrform"> 

{% csrf token $%} 

<div class="writebox"> 

<textarea name="comment" form="usrform"></textarea> 

</div> 

<div class="comments-box-button clearfix"> 

<input type="submit"” value=" 发 布 " class=" j cc post entry cc-post-entry" 
id="scoreBtn"> 

<div data-role="user-login" class=" j cc post login"></div> 

</div> 

<div id="scoreTips2" style="padding-top:10px;"></div> 

</form> 


# 显示 当前 分 页 的 歌曲 点 评 信息 ， 生 成 点 评 信息 列表 


<ul class="comment-list"> 
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{% for item in contacts.object list %} 
<li class="comment-item "> 
<div class="comments-user"> 
<span class="face"> 
# 用 户头 像 ， 统 一 使 用 默认 头像 
<img src="{% static "image/user.jpg" $%}" width="60" height="60"> 
</span> 
</div> 
<div class="comments-list-content"> 
<div class="single-score clearfix"> 
# 点 评 日 期 和 用 户 名 
<span class="date">{{ item.comment date }}</span> 
<div><span class="score">{{ item.comment user }}</span></div> 





comments-content--> 
<div class="comments-content"> 
<div class="J CommentContent comment-height-limit"> 
<div class="content-inner"> 
<div class="comments-words"> 
# 点 评 内 容 
<p>{{ item.comment text }}</p> 
</div> 
</div> 
</div> 
</div> 
</div> 
</1i> 
{% endfor %} 
</ul> 


# 分 页 导航 
<div class="pagebar" id="pageBar"> 
# 上 一 页 的 按钮 
{% if contacts.has previous %} 
<a href="{% url "comment' song id %}?page={{ contacts.previous page_ 
number }}" 
class="prev" target=" self"><i></i> 上 一 页 </a> 
{g% endif %} 
# 列举 全 部 页 数 按钮 


{$$ for page in contacts.paginator.page range %} 


{g% if contacts.number == page %} 
<span class="sel">{{ page }}</span> 
{% else %} 


<a href="{% url ‘'comment' song id %}?page={{ Page }}" 
target=" self">{{ page }}</a> 
{$$ endif %} 
{g endfor $} 
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# 下 一 页 的 按钮 


{$$ if contacts.has next $%} 


<a href="{$% url ‘comment' song id %}?page={{ contacts.next page number 


class="next" self"> 下 
{$$ endif %} 


</div> 


target=" : 


一 页 <i></i></a> 


从 上 述 代 码 可 以 看 到 ， 歌 曲 点 评 框 是 一 个 form 表单 ， 表 单 通过 编写 HTML 代 


码 实 现 ， 点 评 信息 列表 和 分 页 导航 是 在 分 页 对 象 contacts 的 














项 目 music， 在 浏览 器 上 访问 某 首 歌 




















础 上 实现 的 。 我 们 














html， 运 行 结果 如 图 11-19 所 示 。 
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图 11-19 歌曲 点 评 页 


11.8 歌曲 搜索 


品 





启动 


的 点 评 页 ， 如 http://127.0.0.1:8000/comment/6. 





歌曲 搜索 页 是 通过 触发 网 页 顶部 的 搜索 框 
而 生成 的 网 页 ,用 户 输入 内 容 可 以 实现 歌曲 搜索 ， 
搜索 结果 在 歌曲 搜索 页 显示 。 歌 曲 搜索 页 由 项 目 
music 的 search 实现 ， 在 search 目录 下 创建 模板 
文件 夹 templates， 并 在 文件 夹 中 放置 模板 文件 
search.html， 如 图 11-20 所 示 。 
从 前 面 的 章节 可 以 知道 ， 网 页 顶部 的 搜索 
{% url 'search' 1 a 
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Y Bsearch 
> Ea migrations 
v Batemplates 
访 searchhtml 

柱 _jinit_.py 
访 admin.py 
访 apps.py 
和 models.py 
访 tests.py 
访 urls.py 
及 views.py 








图 11-20 search 目录 结构 
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搜索 请 求 ， 该 请 求 是 一 个 POST 请 求 。 因 此 ， 我 们 在 search 的 urlspy 和 views.py 中 
编写 相关 的 功能 代码 ， 代 码 如 下 : 


# search 的 urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
path('<int:page>.html', views.searchView, name='search'), 


# search 的 views.py 
from django.shortcuts import render, redirect 
from django.core.paginator import Paginator, EmptyPage, PageNotAnIinteger 
from django.db.models import Q 
from index.models import * 
def searchView (request, page): 
if request.method == 'GET': 
# 搜索 歌曲 
search song = Dynamic.objects.select related('song'). 
order by('-dynamic search') .all()[:6] 
# 获取 搜索 内 容 ， 如 果 kword 为 空 就 查询 全 部 歌曲 
kword = request.session.get('kword', '') 
if kword: 
# Q 是 SQL 语句 里 的 or 语法 
song_info = Song.objects.values('song id', 'song name', 
'song_ singer', 'song time').filter(Q(song name __ 
icontains=kword) | Q(song singer=kword)) .order_ 
by('-song_ release') .all() 
else: 
song_info = Song.objects.values('song id', 'song name', 
"song_singer'， 'song time') .order by('-song_ 
release') .all()[:50] 
# 分 页 功能 
paginator = Paginator(song info, 5) 
ErYs 
contacts = paginator.page (page) 
except PageNotAnInteger: 
contacts = paginator.page(1) 
except EmptyPage: 
contacts = paginator.page (paginator.num pages) 
# 添加 歌曲 搜索 次 数 
song exist = Song.objects.filter(song name=kword) 
if song exist: 
song id = song exist[0] .song id 
dynamic info = Dynamic.objects.filter(song id=int (song id)). 
first () 
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# 判断 歌曲 动态 信息 是 否 存在 ， 存 在 就 在 原来 的 基础 上 加 1 
if dynamic info: 
dynamic info.dynamic search += 1 
dynamic info.save() 
# 车 动态 信息 不 存在 ， 则 创建 新 的 动态 信息 
eises 
dynamic = Dynamic(dynamic plays=0,dynamic 
search=1,dynamic down=0,song id=song id) 
dynamic.save() 
return renderl(request, 'search.html', locals()) 
elses 
# 处 理 PosT 请 求 ， 并 重 定向 搜索 页 面 
request.session['kword'] = request.POST.get('kword', '') 
return redirect('/search/1.html') 


从 上 述 代码 看 到 ， 歌 曲 搜索 页 的 URL 命名 为 search， 响 应 处 理由 视图 函数 


searchView 执行 ， 并 且 URL 设置 了 参数 page， 该 参数 代表 搜索 结果 的 分 页 页 数 。 在 
views.py 中 分 析 视 图 函数 searchView， 了 解 歌曲 搜索 的 实现 过 程 ， 说 明 如 下 : 


e@ 当 用 户 点 击 搜索 框 的 “搜索 ”按钮 后 ， 程 序 根据 form 表单 的 action 所 指向 
的 URL 发 送 一 个 POST 请 求 ，URL 接收 到 请 求 后 ， 将 请 求 信息 交 给 视图 函数 
searchView 进行 处 理 。 

e ”如果 视图 函数 searchView 收 到 一 个 POST 请求， 首先 将 请 求 参数 kword 写 入 
用 户 的 Session 进行 存储 ， 请 求 参 数 kword 是 搜索 框 的 文本 输入 框 ， 然 后 以 重 
定向 的 方式 跳 回 歌曲 搜索 页 的 URL。 

e 当 歌 曲 搜 索 页 的 URL 以 重 定 向 的 方式 访问 时 ， 相 当 于 向 网 站 发 送 一 个 GET 
请 求 ， 视 图 函数 searchView 首先 获取 用 户 的 Sesssion 数据 ， 判 断 Session 数据 
的 kword 是 否 存在 。 

e。 如果 kword 存在 ， 以 kword 作为 查询 条 件 ， 分 别 在 歌曲 信息 表 song 的 字段 
song_name 和 song_singer 中 进行 模糊 查询 ， 并 将 查询 结果 以 歌曲 发 行 时 间 进 
行 排序 ;如 果 kword 不 存在 ， 以 歌曲 发 行 时 间 的 先后 顺序 对 歌曲 信息 表 song 
进行 排序 ， 并 且 获 取 前 50 首 的 歌曲 信息 。 

e 将 查询 结果 进行 分 页 处 理 ， 以 每 5 首 歌 为 一 页 的 方式 进行 分 页 。 其 中 ， 函 数 
searchView 的 参数 page 是 分 页 的 页 数 。 

@ ”根据 搜索 内 容 kword 查找 完全 匹配 的 歌 名 ， 只 有 匹配 成 功 ， 才 会 判断 歌曲 的 
动态 信息 是 否 存在 。 若 动态 信息 存在 ， 则 对 该 歌曲 的 搜索 次 数 累 加 1， 否 则 为 
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歌曲 新 建 一 条 动态 信息 ， 并 将 搜索 次 数 设 为 1。 
e。 最 后 将 分 页 对 象 contacts 传递 给 模板 search.html， 由 模板 引 掌 进行 解析 并 生成 
相应 的 HTML 网 页 。 


当 模 板 search_html 接收 分 页 对 象 contacts 时 ， 模 板 引 擎 会 对 模板 语法 进行 解析 并 
转换 成 HTML 网 页 。 我 们 根据 分 页 对 象 contacts 在 模板 search.html 中 编写 相关 的 模板 
语法 ， 分 页 对 象 contacts 主要 实现 当前 分 页 的 数据 列表 和 分 页 导航 功能 ， 其 模板 语法 
如 下 : 


# 模板 search 的 功能 代码 
# 当前 分 页 的 数据 列表 
<ul class="songlist list"> 
{%for list in contacts.object list %} 
<li class="js_ songlist child"> 
<div class="songlist item"> 
<div class="songlist _ songname"> 
<span class="songlist songname txt"> 
<a href="{% url "Play' list.song id %}" 
class="js_song" target="play" >{{list.song_ 
name}}</a> 
</span> 
</div> 
<div class="songlist artist"> 
<a href="javascript:;" class="singer name" >{{list. 
song_singer}}</a> 
</div> 
<div class="songlist time">{{list.song time}}</div> 
</div> 
<J1i> 
{Sendfor %} 
</ul> 


# 分 页 导航 功能 
<div class="pagebar" id="pageBar"> 
# 上 一 页 的 按钮 
{% if contacts.has previous %} 

<a href="{% Url 'search' contacts.previous page number $%}" 

class="prev" target=" self"><i></i> 上 一 页 </a> 

{% endif %} 
# 列举 全 部 页 数 按钮 
{$$ for page in contacts.paginator.page range %} 

{$% if contacts.number == Page $$} 

<span class="sel">{{ page }}</span> 
{ else $} 
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{S$ endi 
$ endfor 


{$% if cont. 





$$ endif $%} 
</div> 
从 上 述 代 码 可 知 ， 歌 曲 搜索 主要 是 Django 分 页 功能 的 应 / 


<a href="{% url'search'page $}"target=" self">{{page}}</a> 


£f %} 
$$} 


# 下 一 页 的 按钮 


acts.has next %} 


<a href="{% url 'search' contacts.next page number $%}" 


class="next" target=" self"> 下 一 页 <i></i></a> 





























1， 除 此 之 外 还 涉及 歌 








曲 搜索 次 数 的 累加 和 Session 的 使 用 。 启 动 项 目 music， 在 搜索 框 中 进行 两 次 搜索 ， 第 
一 次 是 有 搜索 内 容 进行 搜索 ， 第 二 次 是 没有 搜索 内 容 直 接 搜索 ， 运 行 结果 如 图 11-21 


所 示 。 

















人 0 我 的 音乐 











Bm a ee 



































9 用 户 


图 11-21 歌曲 搜索 页 ( 左 图 有 搜索 内 容 、 右 图 无 搜索 内 容 ) 


注册 与 登录 





户 管理 的 存在 。 
以 使 用 Django 
理由 项 目 music 
文件 formpy 和 

















用 户 注册 与 登录 是 用 户 管理 的 必 备 功能 之 一 ， 没 有 用 








只 要 涉及 用 户 方面 的 功能 ， 我 们 都 可 
内 置 的 Auth 认证 系统 去 实现 。 用 户 管 
的 user 实现 ， 在 user 目录 下 分 别 创建 
模板 文件 夹 templates， 并 且 在 文件 夹 


























templates 中 创 寻 
图 11-22 所 示 。 














EE 模板 文件 login html 和 home.html， 如 


在 user 目录 中 ， 新 建文 件 分 别 有 home.html、 
login.html 和 form.py， 新 建文 件 分 别 实现 以 下 功能 。 
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户 的 注册 与 登录 ， 就 没有 用 














v Blluser 
> Bmigrations 
v Pltemplates 
访 home.html 
起 loginhtml 
艺 _init_py 
务 adminpy 
也 appspy 
篇 formpy 
笃 models.py 
画 testspy 
wispy 
"i 











图 11-22 user 目录 结构 








第 11 章 
e home.html: 用 户 中心 的 模板 文件 ， 显 示 当 前 用 户 的 基本 信息 和 
放 记 录 。 
elogin.html: 用 户 注 册 与 登录 的 模板 文件 ， 注 册 和 登录 功能 都 是 


eform py: 创建 用 户 注 册 的 表单 类 ， 用 户 注 册 功 能 由 表单 类 实现 。 


由 于 项 目 music 的 用 户 管理 是 在 Django 内 置 的 Auth 认证 系统 的 基 




















用 户 模型 MyUser， 代 码 如 下 : 


# user 的 models.py 
from django.db import models 
from django.contrib.auth.models import AbstractUser 
class MyUser (AbstractUser): 
qq = models.CharField('QQ 号 码 ',， max_ length=20) 
weChat = models.CharField(' 微 信和 账号 '，max_length=20) 
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用 户 的 歌曲 播 


由 同一 个 模板 


础 上 实现 的 ， 





因此 我 们 采用 AbstractUser 方式 对 模型 User 进行 扩展 ， 在 user 的 models.py 中 自 定 义 


mobile = models.CcharField(' 手机 号 码 '， max_ length=11, unique=True) 





# 设置 返回 值 
def str ‘(self):s 
return self.username 














定义 模型 MyUser 之后， 还 需要 在 项 目的 配置 文件 settings.py 9 


Ph 设置 配置 属 


性 AUTH USER MODEL， 和 否则 执行 数据 迁移 时 ，Django 还 是 默认 使 用 内 置 模型 


User。 配 置 属性 如 下 : 


# 配置 文件 settings.py 
# 配置 自 定义 用 户 表 MyUser 
AUTH_USER MODEL = "user.MYUser' 


最 后 ， 在 PyCharm 的 Terminal 模式 下 输入 数据 迁移 指令 ， 在 数据 
的 数据 表 。 我 们 打开 数据 库 music_db 查看 数据 表 的 创建 情况 ， 如 图 11- 





国 django_content type 
国 django_migrations 











图 11-23 数据 库 music_db 的 表 结构 


库 中 创建 相应 
23 所 示 。 
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实现 用 户 的 注册 和 登录 之 前 ， 除 了 自 定 义 用 户 模型 MyUser 之 外 ， 还 需要 定义 用 
户 注 册 的 表单 类 。 用 户 注册 的 表单 类 通过 重 写 Django 内 置 表单 类 UserCreationForm 
即 可 实现 ， 我 们 在 user 的 form.py 中 定义 表单 类 MyUserCreationForm， 代 码 如 下 : 


from django.contrib.auth.forms import UserCreationForm 
from .models import MyUser 
from django import forms 
# 定义 MyUser 的 数据 表单 ， 用 于 用 户 注册 
class MyUserCreationForm(UserCreationForm): 
# 重 写 初始 化 函数 ， 设 置 自 定义 字段 passwordl 和 password2 的 样式 和 属性 
def _init (self, *args, **kwargs): 
super (MyUserCreationForm, self). init  (*args, **kwargs) 
self.fields['passwordl1'] .widget = forms.PasswordInput (attrs= 
{'class': 'txt tabInput','placeholder':' 密码 ,4-16 位 数字 / 字母 / 
特殊 符号 ( 空格 除外 ) ' }) 
self.fields['password2'] .widget = forms.PasswordInput (attrs= 
{'class': 'txt tabInput','placeholder' :' 重复 密码 '}) 
class Meta(UserCreationForm.Meta): 
model = MyUser 
# 在 注册 界面 添加 模型 字段 : 手机 号 码 和 密码 
fields = UserCreationForm.Meta.fields +('mobile',) 
# 设置 模型 字段 的 样式 和 属性 
widgets = { 
'mobile': forms.widgets.TextInput (attrs={'class': 
'txt tabInput', 'placeholder':' 手机 号 '}),'username': 
forms.widgets.TextInput (attrs={'class': 'txt 
tabInput', 'placeholder' :' 用 户 名 '})， 
} 


表单 类 MyUserCreationForm 在 父 类 UserCreationForm 的 基础 上 实现 两 个 功能 : 
添加 用 户 注册 的 字段 和 设置 字段 的 CSS 样式 ， 功 能 说 明 如 下 : 


日 ”添加 用 户 注册 的 字段 : 在 Meta 类 对 fields 属性 设置 字段 即 可 ， 添 加 的 字段 必 
须 是 模型 字段 并 且 以 元 组 或 列表 的 形式 添加 。 

e。 设置 字段 的 CSS 样 式 : 设置 表单 字段 mobile、username、passwordl 和 
password2 的 attrs 属性 。 其 中 ，mobile 和 username 是 模型 MyUser 的 字段 ， 所 
以 在 Meta 类 中 重 写 widgets 属性 即 可 实现 ; 而 passwordl 和 password2 是 父 类 
UserCreationForm 额外 定义 的 表单 字段 ， 所 以 重 写 初始 函数 ”init ”可 以 实现 
字段 样式 设置 。 


完成 模型 MyUser 的 定义 、 数 据 迁 移 和 表单 类 MyUserCreationForm， 接 着 在 user 
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的 urlspy、viewspy 和 login html 中 实现 用 户 的 注册 和 登录 功能 。urlspy 和 views.py 
的 功能 代码 如 下 : 


# user 的 urls.py 

from django.urls import path 

from . import views 

urlpatterns = [ 
# 用 户 的 注册 和 登录 
path('login.html', views.loginView, name='login'), 
# 退出 用 户 登 录 


path('logout.html', views.logoutView, name="'logout'), 


# user 的 views.py 
from django.shortcuts import render, redirect 
from user.models import * 
from django.db.models import Q 
from django.contrib.auth import login, logout 
from django.contrib.auth.hashers import check password 
from .form import MyUserCreationForm 
# 用 户 注册 与 登录 
def loginView (request): 
# 表单 对 象 user 
user = MyUserCreationForm() 
# 表单 提交 
if request.method "POST": 
# 判断 表单 提交 是 用 户 登录 还 是 用 户 注册 
# 用 户 登 录 
if request.POST.get ('loginUser’', ''): 
loginUser = request.POST.get ('loginUser', '') 
password = request.POST.get ('password', '') 
if MyUser.objects .filter (Q (mobile=loginUser) | 
Q(username=loginUser)): 
user = MyUser.objects.filter (Q (mobile=loginUser) | 
Q(username=loginUser)) .first () 
if check password(password, user.password): 
login (request, user) 
return redirect('/user/home/l.html') 
else: 


tips = ' 密码 错误 ' 





else: 
tips = "用 户 不 存在 ' 
# 用 户 注册 
else: 
user = MyUserCreationForm(request .POST) 
if user.is valid() : 
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user.save() 


tips = ' 注册 成 功 ' 


elses 
IE user.errors.get ('username' be 
tips = user.errors.get('username',' 注册 失败 ') 
laek 
tips = user-errors.get('mobile'， ' 注册 失败 ') 
return render(request, ‘login.html', locals()) 


# 退出 登录 


def logoutView (request): 


logout (request) 
return redirect('/') 


上 述 代 码 实现 了 用 户 注册 、 登 录 与 注销 功能 ， 其 中 注销 功能 是 由 Django 的 内 置 
函数 logout 实现 的 ， 此 功能 实现 过 程 较为 简单 ， 此 处 不 做 过 多 介绍 。 我 们 主要 分 析 
用 户 注册 和 登录 功能 的 实现 过 程 ， 由 于 注册 和 登录 都 是 使 用 模板 login.html， 因 此 将 
两 个 功能 放 在 同一 个 视图 函数 loginView 中 执行 处 理 。 用 户 注册 和 登录 的 实现 过 程 如 


下 : 


首先 视图 函数 loginView 判断 用 户 的 请 求 方式 ， 如 果 是 POST 请 求 ， 该 请 求 可 
能 是 用 户 注册 或 者 用 户 登 录 。 

由 于 注册 和 登录 的 文本 输入 框 的 命名 不 同 ， 因 此 通过 判断 请 求 参数 loginUser 
的 内 容 是 否 为 空 即 可 分 辨 当前 用 户 是 执行 用 户 登 录 还 是 用 户 注册 ， 请 求 参 数 
loginUser 代表 用 户 登 录 的 账号 。 

若 当 前 请 求 执 行 的 是 用 户 登 录 ， 则 以 参数 request 的 方式 获取 请 求 参数 
loginUser 和 password， 然 后 在 模型 MyUser 中 查找 相关 的 用 户 信息 并 进 
行 验证 处 理 。 若 验证 成 功 ， 则 返回 用 户 中 心 页 面 ， 否 则 提示 相应 的 错误 信 
息 。 

若 当 前 请 求 执行 的 是 用 户 注册 ， 则 将 请 求 参数 加 载 到 表单 类 
MyUserCreationForm 中 ， 生 成 用 户 对 象 user， 然 后 验证 用 户 对 象 user 的 
数据 。 若 验证 成 功 ， 则 在 模型 MyUser 中 创建 用 户 信息 ， 和 否则 提示 相应 的 
错误 信息 。 


根据 视图 函数 loginView 的 功能 代码 ， 在 模板 login .html 中 实现 用 户 登 录 和 注册 
的 模板 功能 。 由 于 模板 login.html 的 代码 较 多 , 本 章 只 列 出 用 户 登 录 和 注册 的 功能 代码 ， 
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具体 的 代码 可 以 在 本 书 源 代码 中 查看 。 模 板 login html 的 功能 代码 如 下 : 


# 模板 1ogin .html 的 功能 代码 
# 用 户 登录 
<div class="login-box switch box" style="display:block;"> 
<div class="title"> 用 户 登 录 </div> 
<form id="loginForm" class="formBox" action="" method="post"> 
{% csrf token %} 
# 用 户 名 或 手机 号 
<div class="itembox user-name"> 
<div class="item"> 
<input type: 





text" name="loginUser"” placeholder=" 用 户 名 





或 手机 号 " 
class="txt tabInput"> 
</div> 
</div> 
# 登录 密码 
<div class="itembox user-pwd"> 
<div class="item"> 
<input type="password" name="password" placeholder=" 登 
录 密 码 " 
class="txt tabInput"> 
</div> 
</div> 
# 信息 提示 
{% if tips %} 
<div> 提示 :<span>{{ tips }}</span></div> 
{% endif %} 
# 登录 按钮 
<div id="loginBtnBox" class="login-btn"> 
<input id="J LoginButton" type="submit" value=" 马上 登录 " 
class="tabInput pass-btn"/> 
</div> 
# 切换 注册 界面 
<div class="pass-reglink"> 还 没有 我 的 音乐 账号 ? 
<a class="switch" href="javascript:; > 免费 注册 </a> 
</div> 
</form> 
</div> 
# 用 户 注册 


<div class="regist-box Switch box" style="display:none;"> 

<div class="title"> 用 户 注册 </div> 

<form id="registerForm" class="formBox" method="post" action=""> 
{% csrf token %} 
<div id="registForm" class="formBox"> 


# 用 户 名 
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<div class="itembox user-name"> 
<div class="item">{{ user.username }}</div> 
</div> 
# 手机 号 码 
<div class="itembox user-name"> 
<div class="item">{{ user.mobile }}</div> 
</div> 
# 用 户 密码 
<div class="itembox user-pwd"> 
<div class="item">{{ user.passwordl }}</div> 
</div> 
# 用 户 密码 
<div class="itembox user-pwd"> 
<div class="item">{{ user.password2 }}</div> 
</div> 
# 信息 提示 
{% if tips %} 
<div> 提示 :<span>{{ tips }}</span></div> 
{% endif %} 
# 用 户 注册 协议 
<div class="member-pass clearfix"> 
<input id="agree" name="agree" checked="checked" 
type="checkbox" value="1"> 
<label for="agree"” class="autologon"> 已 阅读 并 同意 用 户 注册 协议 </ 
label> 
</div> 
# 注册 按钮 
<input type="submit" value=" 免费 注册 " id="J RegButton" class="pass-btn 
tabInput"/> 
# 切换 登录 界面 
<div class="pass-reglink"> 已 有 我 的 音乐 账号 ， 
<a _ class="switch"” href="javascript:;"> 立即 登录 </a> 
</div> 
</div> 
</form> 
</div> 


从 模板 login.html 的 代码 可 以 看 到 ， 用 户 登录 和 注册 是 由 不 同 的 表单 分 别 实现 
的 。 其中， 用 户 登 录 表 单 是 由 HTML 代码 编写 实现 的 ， 因 此 视图 函数 loginView 
只 能 通过 参数 request 的 方式 获取 表单 数据 ; 用 户 注 册 表 单 是 由 Django 的 表单 类 
MyUserCreationForm 生成 的 , 因此 可 以 由 表单 类 MyUserCreationForm 获取 表单 数据 。 


上 述 例 子 分 别 列 出 了 两 种 不 同 的 表单 的 应 用 方式 ， 两 者 各 有 优 缺 点 ， 在 日 常 开 
发 过 程 中 ， 应 结合 实际 情况 选择 合适 的 表单 应 用 方式 。 
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11.10 用 户 中 心 


用 户 中 心 是 项 目 应 用 user 的 另 一 个 应 用 页 面 ， 主 要 在 用 户 登 录 后 显示 用 户 基 本 
信息 和 用 户 的 歌曲 播放 记录 。 因 此 ， 用 户 访问 用 户 中 心 时 ， 必 须 检验 当前 用 户 的 登录 
状态 。 由 于 用 户 中心 是 在 user 中 实现 的 ， 因 此 在 user 的 urlspy 和 views.py 中 添加 以 
下 代码 : 








# user 的 urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
# 用 户 的 注册 和 登录 
path('login.html', views.loginView, name='login'), 
# 用 户 中 心 
path('home/<int:page>.html', views.homeView, name='home'), 
# 退出 用 户 登 录 
path('logout.html', views.logoutView, name='logout'), 


] 


# user 的 views.py 
from django.contrib.auth.decorators import login required 
from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger 
# 用 户 中心 
# 设置 用 户 登 录 限 制 
@login required(login url='/user/login.html') 
def homeView (request, page): 
# 热 搜 歌曲 
search song = Dynamic.objects.select related('song') .order by('- 
dynamic search') .all() [:4] 
# 分 页 功能 
song_info = request.session.get('play list', []) 
paginator = Paginator(song info, 3) 
try: 
contacts = paginator.page (page) 
except PageNotAnInteger: 
contacts = paginator.page (1) 
except EmptyPage: 
contacts = paginator.page (paginator.num pages) 
return render (equest， 'home.html', locals()) 


从 上 述 代码 可 以 看 到 ， 用 户 中 心 的 URL 命名 为 home， 视 图 函数 为 homeView， 
URL 的 参数 page 代表 页 数 。 视 图 函数 homeView 实现 歌曲 播放 记录 的 分 页 处 理 ， 歌 
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曲 播放 记录 来 自 于 当前 用 户 的 播放 列表 ， 由 Session 的 play_list 进行 存储 。 


但 从 网 站 的 需求 与 设计 来 看 ， 用 户 中 心 主要 显示 当前 用 户 的 基本 信息 和 用 户 的 歌 
曲 播放 记录 。 视 图 函数 homeView 只 实现 歌曲 播放 记录 ， 而 用 户 信息 由 Django 自动 
完成 。 回 顾 9.6 节 可 以 知道 ， 在 配置 文件 settings.py 中 设置 处 理 器 django.contrib.auth. 
context_processors.auth， 当 使 用 Django 内 置 Auth 实现 用 户 登 录 时 ，Django 自动 生成 
变量 user 和 perms 并 传 入 模板 变量 TemplateContext。 因 此 ， 模 板 home.html 的 功能 代 
码 如 下 : 


# home .html 的 功能 代码 
# 用 户 信息 
<div class="section inner"> 
# 用 户头 像 
<div class="profile cover link"> 
<img src="{% static "image/user.jpg" %}" class="profile cover"> 
</div> 
# 用 户 名 
<hl class="profile tit"> 
<span class="profile name">{{ user.username }}</span> 
</hl> 
# 退出 登录 
<a href="{% url 'logout' %}"” style="color:white;"> 退出 登录 </a> 
</div> 


# 歌曲 列表 信息 
<ul class="songlist list"> 
{% for item in contacts.object list %} 
<1li> 
<div class="songlist item songlist item--even"> 
<div class="songlist songname"> 
<a href="{% url 'play' item.song id %}" 
class="js_song songlist songname txt" >{{ item.song_ 
name }}</a> 
</div> 
<div class="songlist artist"> 
<a href="javascript:;" class="singer name">{{ item.song singer 
}}</a> 
</div> 
<div class="songlist time">{{ item.song time }}</div> 
</div> 
</1i> 
{ endfor $} 
</ul> 
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# 分 页 导航 按钮 
<div class="pagebar" id="pageBar"> 
# 上 一 页 的 按钮 
{% if contacts.has previous $%} 
<a href="{% url 'home' contacts.previous page number %}" 
class="prev" target=" self"><i></i> 上 一 页 </a> 
{g% endif %} 
# 列举 全 部 页 数 按钮 


{$% for page in contacts.paginator.page range $} 


{% if contacts .number == page %} 
<span class="sel">{{ page }}</span> 
{% else 要 } 


<a href="{% url 'home' page %}" target=" self">{{ page }}</a> 

{% endif %} 
{% endfor %} 
# 下 一 页 的 按钮 
{% if contacts.has next %} 

<a href="{% url "home' contacts.next page number $%}" 

class="next" target=" self"> 下 一 页 <i></i></a> 

{% endif %} 
</div> 


我 们 在 浏览 器 上 访问 http://127.0.0.1:8000/user/home/1.html， 查 看 当前 用 户 的 基本 
信息 和 歌曲 播放 记录 ， 如 图 11-24 所 示 。 





加 我 的 音 























图 11-24 用 户 中 心 








11.11 Admin 后 台 系 统 











在 前 面 的 章节 中 ， 我 们 已 完成 网 站 界面 的 基本 开发 ， 接 下 来 讲述 网 站 Admin 后 
台 系 统 的 开发 。Admin 后 台 系 统 主要 方便 网 站 管理 员 管理 网 站 的 数据 和 网 站 用 户 。 
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在 项 目 music 的 index 和 user 中 分 别 定义 模型 Label、Song、Dynamic、Comment 和 
MyUser， 由 于 index 和 user 是 两 个 独立 的 App， 因 此 在 Admin 后 台 系 统 中 是 区 分 两 
个 功能 模块 的 。 


首先 实现 index 在 Admin 后 台 系 统 的 功能 模块 ， 在 ndex 的 _ init py 和 adminpy 
中 分 别 编写 以 下 代码 : 


# index 的 _ init .py 

# 对 功能 模块 进行 命名 

from django.apps import AppConfig 

import os 

# 修改 App 在 Admin 后 台 显示 的 名 称 

# default_app_config 的 值 来 自 apps .py 的 类 名 
default app_ config = 'index.IndexConfig"' 


# 获取 当前 App 的 命名 
def get current app name( file): 
return os.path.split(os.path.dirname( file)) [-1] 


# 重 写 类 IndexConfig 

class IndexConfig (AppContfig): 
name = get _ current app name(_ file ) 
verbose_name = ' 网 站 首页 ' 


# index 的 admin.py 

from django .contrib import admin 

from .models import * 

# 修改 title 和 header 

admin.site.site title =' 我 的 音乐 后 台 管理 系统 ' 
admin.site.site_header = ' 我 的 音乐 ' 


# 模型 Label 
@admin.register (Label) 
class LabelAdmin (admin.ModelAdmin): 
# 设置 模型 字段 ， 用 于 Admin 后 台数 据 的 表 头 设置 
list display = ['label id', 'label name'] 
# 设置 可 搜索 的 字段 并 在 Admin 后 台数 据 生成 搜索 框 ， 如 有 外 键 应 使 用 双 下 画 线 连接 两 个 模 


型 的 字段 
search fields = ['label name'] 
# 设置 排序 方式 
ordering = ['label id'] 
# 模型 song 


@admin.register (Song) 
class SongAdmin(admin.ModelAdmin): 
list display = ['song id','song name','song singer', 
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"song_album'v "song languages','song release'] 
search fields = 
languages'] 


['song name','song singer','song album','song_ 
# 设置 过 滤器 ， 在 后 台数 据 的 右 侧 生成 导航 栏 ， 如 有 外 键 应 使 用 双 下 画 线 连接 两 个 模型 的 字段 
list filter = ['song singer'v "song album','song languages'] 
ordering = ['song id'] 
# 模型 Dynamic 
Qadmin.register (Dynamic) 
class DynamicAdmin (admin.ModelAdmin): 
list display = ['dynamic id','song', 'dynamic plays', 'dynamic _ 
search', 'dynamic down'] 
search fields 


list filter 
ordering 


['song'] 


['dynamic plays','dynamic search', 'dynamic down'] 
= ['dynamic id'] 
# 模型 comment 
@admin.register (Comment) 
class CommentAdmin (admin.ModelAdmin): 
list display = ['comment id','comment text','comment_ 
user', 'song', 'comment date'] 


search fields = ['comment user','song','comment date'] 
list filter = ['song','comment date'] 
ordering ['comment _ id'] 


从 上 述 代码 可 以 看 到 ，index 的 ”init .py 用 于 设置 功能 模块 的 名 称 ，admin.py 
分 别 将 模型 Label、Song、Dynamic 和 Comment 六 











E 册 到 Admin 后 台 系统 并 设置 相应 
的 显示 方式 。 在 浏览 器 上 访问 Admin 后 台 系统 并 使 








超级 管理 员 账号 进行 登录 ， 在 
Admin 的 首页 可 以 看 到 index 的 功能 模块 ， 如 图 11-25 所 示 。 


€ $ © O170010000/admin 








站 点 管理 








十 了 下 





图 11-25 Admin 后 台 系 统 


最 后 在 user 的 _init .py 和 adminpy 中 将 自 定 义 模 型 MyUser 注册 到 Admin 后 
台 系 统 ， 代 码 如 下 : 
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# user 的 _init .py 

# 设置 App (user) 的 中 文 名 

from django.apps import AppConfig 

import os 

# 修改 App 在 admin 后 台 显示 的 名 称 

# default_app_config 的 值 来 自 apps .py 的 类 名 
default app config = "user.IndexConfig' 


# 获取 当前 App 的 命名 
def get current app name( file): 
return os.path.split (os.path.dirname ( file)) [-1] 


# 重 写 类 IndexConfig 

class IndexConfig (APPConfig) : 
name = get_current_app_name(_ file ) 
verbose_name = ' 用 户 管理 ' 


# user 的 admin.py 
from django.contrib import admin 
from .models import MyUser 
from django.contrib.auth.admin import UserAdmin 
from django.utils.translation import gettext lazy as _ 
Qadmin.register (MyUser) 
class MyUserAdmin (UserAdmin): 
list display = ['username','email','mobile','qq', 'weChat'] 
# 在 用 户 信息 修改 界面 添加 'mobile'、'qq'、'weCchat' 的 信息 输入 框 
# 将 源码 的 Useradmin.fieldsets 转换 成 列表 格式 
fieldsets = list(UserAdmin .fieldsets) 
# 重 写 UserAdmin 的 fieldsets， 添 加 'mobile'、'qq'、'weChat' 的 信息 录入 
fieldsets[1] = (_('Personal info'), 
{'fields': ('first name', 'last name', 'email', 
'mobile', 'gq', 'weChat')}) 


由 于 模型 MyUser 继承 Django 内 置 模型 User， 因 此 将 MyUserAdmin 继承 
UserAdmin 即 可 使 用 内 置 模型 User 的 Admin 后 台 功 能 界面 ， 并 且 通 过 重 写 的 方式 ， 
根据 模型 MyUser 的 定义 进一步 调整 模型 User 的 Admin 后 台 功 能 界面 。 在 浏览 器 上 
访问 Admin 后 台 系统 ， 在 Admin 首页 找到 名 为 “用 户 ” 的 地 址 链接 并 单 击 访问 ， 
进入 用 户 信 息 列 表 并 修改 某 一 用 户 信息 ， 可 以 看 到 个 人 信息 新 增 字 段 的 信息 ， 如 图 
11-26 所 示 。 
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11-26 Admin 后 台 系 统 


11.12 自 定 义 异 常 机 制 


网 站 的 异常 是 一 个 普遍 存在 的 问题 ， 常 见 的 异常 以 404 或 500 为 主 。 异 常 的 
出 现 主要 是 网 站 自身 的 数据 缺陷 或 者 人 为 不 合理 的 访问 所 导致 的 。 比 如 网 站 链接 为 
http://127.0.0.1:8000/play/6.html， 其 中 链接 中 的 6 代表 歌曲 信息 表 的 主键 ， 如 果 在 歌曲 
信息 表 中 不 存在 该 数据 ， 那 么 网 站 应 抛 出 404 异常 。 

为 了 完善 音乐 网 站 的 异常 机 制 ， 我 们 对 网 站 的 404 异常 进行 自 定义 设置 。 首 先 在 
项 目 music 的 根 目录 的 templates 中 加 入 模板 error404.html， 如 图 11-27 所 示 。 











~ Mm music E\music 
> Bi comment 


<*vvvvvv 
8 
a 
外 
En 
中 


> Puser 











图 11-27 项 目 music 的 目录 结构 





由 于 网 站 的 404 异常 是 作用 在 整个 网 站 的 ， 因 此 在 项 目 music 的 urls.py 中 设置 
404 的 URL 信息 ， 代 码 如 下 : 
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# 项 目 music 的 urls.py 

# 设置 404、500 错误 状态 码 

from index import Views 
handler404 = views.page not found 
handler500 = views.page not found 


可 以 看 到 ， 网 站 的 404 和 500 异常 信息 都 是 由 index 的 视图 函数 page_not found 
进行 处 理 的 。 所 以 我 们 在 index 的 views.py 中 编写 视图 函数 page_not found 的 处 理 过 程 ， 
代码 如 下 : 

# index 的 views.py 

# 自 定义 404 和 500 的 错误 页 面 


def page not found (request) : 
return render(request, ‘error404.html', status=404) 


上 述 例子 是 网 站 自 定义 404 异常 信息 ， 实 现 方式 相对 简单 ， 只 需 在 项 目 music 的 
trls.py 中 设置 404 或 500 的 视图 函数 即 可 实现 。 当 网 站 出 现 异常 的 时 候 ， 异 常 处 理 都 
会 由 视图 函数 page_not_found 进行 处 理 。 


11.13 项 目 上 线 部 署 


由 于 自 定义 的 异常 功能 需要 项 目 上 线 后 才能 测试 运行 状况 ， 因 此 我 们 将 项 目 
music 由 开发 模式 改 为 项 目 上 线 模式 。 首 先 在 配置 文件 settings.py 中 关闭 debug 模式 、 
设置 域名 访问 权限 和 静态 资源 路 径 ， 代 码 如 下 : 

# 关闭 debug 模型 

DEBUG = False 

# 允许 所 有 域名 访问 

ALLOWED HOSTS = ['*'] 

# 静态 资源 路 径 

# STATIC_ROOT 设置 项 目 上线 后 使 用 的 静态 资源 

STATIC ROOT = 'e:/music/static' 

# STATICFILES_DIRS 将 Admin 的 静态 资源 保存 在 static 文件 夹 中 

STATICFILES DIRS = [os.path.join (BASE DIR, 'static'),] 

当 开启 debug 模式 时 ，Django 本 身 是 提供 静态 资源 服务 的 ， 主 要 方便 开发 者 开发 
网 站 功能 。 当 关闭 debug 模式 时 ， 开 发 模式 转 为 项 目 上 线 模式 ，Django 就 不 再 提供 静 
态 资源 服务 ， 该 服务 应 交 由 服务 器 来 完成 。 


在 上 述 设 置 中 ，STATIC ROOT 和 STATICFILES_DIRS 都 指向 项 目 music 根 目录 
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的 static 文件 夹 。 首 先 将 Admin 后 台 的 静态 资源 保存 在 static 文件 夹 中 ， 在 PyCharm 
的 Terminal 下 输入 以 下 指令 : 


# Admin 静态 资源 的 收集 指令 
E:\music>python manage.py collectstatic 
# 信息 提示 ， 是 否 覆 盖 现 有 的 static 文件 夹 
You have requested to collect static files at the destination 
location as specified in your settings: 
e:\music\static 
This will overwrite existing files! 
Are you sure you want to do this? 
# 输入 yes 并 按 回 车 键 


Type "Yes' to continue, or 'no' to cancel: yes 


指令 执行 完毕 后 ， 我 们 打开 项 目 music 根 目录 的 static 文件 夹 ， 在 其 目录 下 新 增 
admin 文件 夹 ， 如 图 11-28 所 示 。 





Ba songLyric 
外 favicon.ico 











11-28 static 目录 结构 


然后 在 项 目 music 的 urls.py 中 设置 静态 资源 的 读 取 路 径 。 一 般 来 说 ， 项 目 上 线 
的 静态 资源 都 是 由 配置 属性 STATIC_ROOT 来 决定 的 。 因 此 ， 项 目 music 的 urls.py 
设置 如 下 : 





from django.contrib import admin 

from django.urls import path, include 

from django.conf.urls import url 

from django.views import static 

from django.conf import settings 

urlpatterns = [ 
path('admin/', admin.site.urls), 
path('', include('index.urls')), 
path('ranking.html', include('ranking.urls')), 
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] 


path('play/', include('play.urls')), 
path('comment/', include('comment.urls')), 
path('search/', include('search.urls')), 
path('user/', include('user.urls')), 
# 设置 项 目 上 线 的 静态 资源 路 径 
url('^static/(?P<path>.*)$', static.serve, 
{'document root': settings.SsTATIC ROOT}, name='static') 


完成 上 述 配置 后 ， 我 们 重启 项 目 music 并 在 浏览 器 上 打开 http://127.0.0.1:8000/ 
play/666.html， 运 行 结果 如 图 11-29 所 示 。 


非常 抱歉 您 访问 的 页 面 不 存在 > < 


回 到 首页 | 





图 11-29 自 定义 404 界面 


11.14 本 章 小 结 


音乐 网 站 的 功能 分 为 : 网 站 首页 、 歌 曲 排行 榜 、 歌 曲 播放 、 歌 曲 搜索 、 歌 曲 点 评 
和 用 户 管理 ， 各 个 功能 说 明 如 下 : 
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网 站 首页 是 整个 网 站 的 主 界面 ， 主 要 显示 网 站 最 新 的 动态 信息 以 及 网 站 的 功 
能 导航 。 网 站 动态 信息 以 歌曲 的 动态 为 主 ， 如 热门 下 载 、 热 门 搜索 和 新 歌 扒 
荐 等 ; 网 站 的 功能 导航 是 将 其 他 页 面 的 链接 展示 在 首页 上 , 方便 用 户 访问 浏览 。 
歌曲 排行 榜 是 按照 歌曲 的 播放 量 进行 排序 ， 用 户 还 可 以 根据 歌曲 类 型 进行 自 
定义 筛选 。 

歌曲 播放 是 为 用 户 提供 在 线 试听 功能 ， 此 外 还 提供 歌曲 下 载 、 歌 曲 点 评 和 相 
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关 歌 曲 推荐 。 

。 ”歌曲 点 评 是 通过 歌曲 播放 页 面 进入 的 ， 每 条 点 评 信息 包含 用 户 名 、 点 评 内 容 
和 点 评 时 间 。 

。 ”歌曲 搜索 是 根据 用 户 提供 的 关键 字 进 行 歌曲 或 歌手 匹配 查询 的 ， 搜 索 结果 以 
数据 列表 显示 在 网 页 上 。 

e 用户 管理 分 为 用 户 注 册 、 登 录 和 用 户 中 心 。 用 户 中 心包 含 用 户 信息 、 登 录 注 
销 和 歌曲 播放 记录 。 


网 站 首页 主要 以 数据 查询 为 主 ， 由 Django 内 置 的 ORM 框架 提供 的 API 实现 数 
据 查询 ， 查 询 结果 主要 以 模板 语法 for 标签 和 让 标签 共同 实现 输出 并 转换 成 相应 的 
HTML 网 页 。 

歌曲 排行 榜 以 GET 请 求 进行 歌曲 筛选 。 若 不 存在 请 求 参 数 ， 则 将 全 部 歌曲 按 播 
放量 进行 排序 显示 ， 若 存在 请 求 参 数 ， 则 对 歌曲 进行 筛选 并 按 播放 量 进行 排序 显示 。 
歌曲 排行 榜 还 可 以 使 用 Django 的 通用 视图 实现 。 

歌曲 播放 主要 实现 文件 下 载 、Session 的 应 用 和 数据 库 操 作 。 使 用 
StreamingHttpResponse 对 象 作 为 响应 方式 ， 为 用 户 提供 文件 下 载 功 能 ， 歌 曲 播放 列表 
使 用 Session 实现 ， 主 要 对 Session 的 数据 进行 读 写 操作 ;数据 库 操 作 主 要 对 歌曲 动 
态 表 dynamic 进行 数据 的 新 增 或 更 新 。 

歌曲 点 评 主要 使 用 表单 和 分 页 功能 。 歌曲 点 评 框 是 由 HTML 编写 的 表单 实现 的 ， 
通过 视图 函数 的 参数 request 获取 表单 数据 ， 实 现 数据 入 库 处 理 ; 分 页 功能 是 将 当前 
歌曲 的 点 评 信息 进行 分 页 显示 。 

用 户 管理 是 在 Django 的 Auth 认证 系统 上 实现 的 ， 用 户 信 息 是 在 内 置 模 型 User 
的 基础 上 进行 扩展 的 ， 用 户 注册 是 在 内 置 表单 类 UserCreationForm 的 基础 上 实现 的 
用 户 登 录 由 内 置 函数 check_password 和 login 共同 实现 ， 用 户 中 心 使 用 过 滤器 login_ 
required 实现 访问 限制 ， 并 由 处 理 器 context_processors.auth 自动 生成 用 户 信 息 ， 最 后 
使 用 Session 和 分 页 功能 实现 歌曲 播放 记录 的 显示 。 

网 站 后 台 主 要 使 用 Admin 后 台 的 基本 设置 ， 如 App 的 命名 方法 、Admin 的 标题 
设置 和 模型 注册 与 设置 。App 的 命名 方法 是 由 App 的 初始 化 文件 _ init _.py 实现 的 ， 
Admin 的 标题 设置 和 模型 注册 与 设置 在 App 的 admin.py 中 实现 。 
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目前 部 署 Django 项目 有 两 种 主流 方案 Nginx+uWSGIHDiango 或 者 Apache+ 
uWSGI+Django。Neginx 作为 服务 器 最 前 端 ， 负责 接收 浏览 器 的 所 有 请 求 并 统 
一 管理 。 静 态 请 求 由 Nginx 自己 处 理 ， 非 静态 请 求 通过 uWSGI 服务 器 传递 给 
Django 应 用 ， 由 Django 进行 处 理 并 做 出 响应 ， 从 而 完成 一 次 Web 请 求 。 本 章 以 
NginxtuWSGI+Django 为 例 讲述 如 何在 Linux 系统 上 部 署 Django 应 用 。 


12.1 安装 Linux 虚拟 机 


大 多 数 开发 者 都 是 使 用 Windows 操作 系统 进行 项 目 开发 的 ， 而 项 目的 部 署 都 是 
选择 Linux 操作 系统 为 主 。 因 此 ， 我 们 在 Windows 上 安装 虚拟 机 VirtualBox (全称 
Oracle VM VirtualBox) 。 读 者 可 以 在 https://www.virtualbox.org/wiki/Downloads 下 载 
软件 安装 包 或 者 在 网 上 搜索 相关 资源 下 载 安装 。 
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虚拟 机 VirtualBox 安装 成 功 后 ， 运 行 虚拟 机 VirtualBox， 主 界面 如 图 12-1 所 示 。 





图 12-1 虚拟 机 VirtualBox 主 界面 


单 击 “ 新 建 ”按钮 ， 在 虚拟 机 中 创建 一 个 虚拟 电脑 ， 并 输入 虚拟 电脑 的 名 称 、 
选择 电脑 系统 的 类 型 和 设置 内 存 大 小 ， 如 图 12-2 所 示 。 


虚拟 电脑 名 称 和 系统 类 型 
名 称 胃 : ICentosT 
类 型 (): [Liaax 

版 本 (Y)。 [Red Hat (64-bit) 



































图 12-2 新 建 虚拟 电脑 





完成 虚拟 电脑 的 基本 配置 后 ， 单 击 “ 创 建 ” 按 钮 ， 虚 拟 机 VirtualBox 生成 创建 虚 
拟 硬 盘 界 面 。 在 创建 虚拟 硬盘 界面 不 做 任何 修改 ， 直 接 单 击 “ 创 建 ” 按 钮 即 可 完成 虚 
拟 电脑 的 创建 。 在 虚拟 机 VirtualBox 的 主 界面 可 以 看 到 刚 创建 的 虚拟 电脑 ， 如 图 12-3 


所 示 。 
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图 12-3 新 建 的 虚拟 电脑 








虚拟 电脑 MyCentOS7 还 没有 安装 相应 的 操作 系统 ， 其 相当 于 一 台 硬 件 已 组 装 好 
的 电脑 。 接 下 来 ， 我 们 会 为 虚拟 电脑 MyCentOS7 安装 相应 的 操作 系统 。 安 装 操作 系 
统 之 前 ， 首 先 设置 虚拟 电脑 MyCentOS7 的 网 络 设置 。 选 中 虚拟 电脑 MyCentOS7 并 单 
击 “ 设 置 ”按钮 ， 进 入 MyCentOS7 的 设置 界面 ， 单 击 “ 网 络 ” 并 设置 网 卡 1 的 网 络 
连接 方式 ， 如 图 12-4 所 示 。 











| 网络 
Bil “疯长 六 网 丰 了 网 长生 
Ed ld 
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六 模式] 全 玉环 让- me 


uc 地 直 加 DOOCTENGET 
BAPE) 
祷 必 人 











图 12-4 MyCentOS7 的 网 络 设置 














虚拟 电脑 MyCentOS7 的 网 络 连 接 方式 改 为 桥接 网 卡 ， 可 以 在 虚拟 电脑 中 使 用 本 
地 系统 的 网 络 服务 ， 实 现 虚 拟 电 脑 和 本 地 系统 的 网 络 通信 。 完 成 网 络 设置 后 ， 回 到 虚 
拟 机 VirtualBox 的 主 界面 ， 然 后 单 击 “启动 ”按钮 ， 启 动 虚拟 电脑 MyCentOS7， 如 图 
12-5 所 示 。 
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图 MyCentOs7 [BE] - Oracle VM VirtualBox -5 





国 习 外 眼 自 回 名 四 











到 12-5 启动 虚拟 电脑 MyCentOS7 





由 于 虚拟 电脑 MyCentOS7 尚未 安装 操作 系统 ， 因 此 首次 启动 虚拟 电脑 
MyCentOS7 会 出 现 选 择 启 动 盘 的 界面 。 我 们 选择 镜像 文件 CentOS-7-x86_64- 
DVD-1708.is0， 镜 像 文件 可 在 CentOS 的 官方 网 站 下 载 (https://www.centos.org/ 
download/) 。 单 击 “ 启 动 ” 按 钮 ， 虚 拟 电脑 MyCentOS7 进入 CentOS 7 的 安装 界面 ， 
如 图 12-6 所 示 。 











到 12-6 CentOS 7 的 安装 界面 








选择 Install CentOS 7 并 按 回 车 键 ， 等 待 系统 运行 完成 后 即 可 进入 CentOS 7 的 安 
装 主 界面 。 在 安装 主 界面 选择 语言 类 型 ， 如 图 12-7 所 示 。 
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本 又 /时代 并 要 Bl 
和文 (所 J 














妈 12-7 CentOS 7 的 安装 主 界面 








单 击 “ 继 续 ” 按 钮 ， 进 入 系统 安装 的 配置 界面 ， 在 此 界面 不 做 任何 修改 ， 选 择 
默认 配置 即 可 ， 如 图 12-8 所 示 。 
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图 12-8 CentOS 7 配置 界面 








单 击 “ 开 始 安装 ”按钮 ， 虚 拟 电 脑 MyCentOS7 会 自动 安装 CentOS 7 系统 ， 在 
安装 过 程 中 设置 ROOT 密码 。 等 到 系统 安装 完成 后 ， 单 击 “ 重 启 ” 按 钮 即 可 进入 
CentOS 7 系统 ， 如 图 12-9 所 示 。 








- 














到 12-9 CentOS 7 系统 
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完成 系统 安装 后 ， 我 们 需要 实现 虚拟 机 系统 与 本 地 系统 间 的 通信 。 首 先 安 装 网 
功能 net-tools， ee 上 输入 安装 指令 yum install net-tools， 等 待 安装 完成 即 可 
然后 修改 当前 网 络 的 配置 文件 , 将 路 径 切 换 到 network-scripts 文件 夹 , 如 图 12-10 所 示 。 


小 





[root@localhost /]# cd /etc/sysconf ig/network-script 
[rootBlocalhost network-scripts]# 

ifcfg-enpgs3 

ifcfg-1lo 


network-function 
network-functions-ipv6 





[root@localhost network 








加 12-10 network-scripts 文件 夹 








从 图 12-10 中 可 以 看 到 ifcfg-enp0s3 文件 ， 这 是 当前 网 络 的 配置 文件 。 其 中 ， 
enp0s3 是 随机 生成 的 ， 具 体 的 命名 按 实际 情况 而 定 。 我 们 输入 编辑 指令 vi ifcfg- 
enp0s3， 修 改 ifcfg-enp0s3 的 配置 信息 ， 将 ONBOOT 的 属性 改 为 yes， 然 后 保存 并 退 
出 编辑 ， 如 图 12-11 所 示 。 














妈 12-11 编辑 ifcfg-enp0s3 





下 一 步 是 关闭 CentOS 7 系统 的 防火 墙 ， 可 以 依次 输入 以 下 指令 : 


sudo systemctl stop firewalld.service 
sudo systemctl] disable firewalld.service 


关闭 防火 墙 后 ， 在 CentOS 7 系统 输入 ifconfig， 查 询 CentOS 7 系统 的 卫 地址， 
如 图 12-12 所 示 。 
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在 本 地 系统 使 用 FileZilla 
理 输入 虚拟 机 CentOS 7 系统 和 








到 12-12 CentOS7 的 IP 地址 





软件 连接 虚拟 机 CentOS 7 系统 ， 
和 具体 信息 即 可 实现 连接 。 


在 FileZilla 的 站 点 管 
使 用 FileZilla 软件 实现 本 地 





系统 与 虚拟 机 系统 
维护 和 更 新 ， 如 图 12-13 所 示 。 





间 的 FTP 通信 ， 


这 样 方便 两 个 系统 之 间 的 文件 传输 ， 利 于 项 目的 





12.2 











色 12-13 FileZilla 





安装 Python 3 





CentOS 7 系统 默认 安装 Python 2.7 版 本 ， 但 Django 2.0 不 支持 Python 2.7 版 本 ， 


因此 我 们 需要 在 CentOS 7 系统 中 


系统 中 安装 Python 3.6。 
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在 安装 Python 3.6 之 前 ， 我 们 分 别 需 要 安装 Linux 的 wget 工具 、GCC 编译 器 环 
境 以 及 Python 3 使 用 的 依赖 组 件 。 相 关 的 安装 指令 如 下 : 


# 安装 Linux 的 wget 工具 ， 用 于 网 上 下 载 文 件 

yum -Y install wget 

# GCC 编译 器 环境 ， 安 装 Python 3 时 所 需 的 编译 环境 

yum -Y install gcc 

# Python 3 使 用 的 依赖 组 件 

yum install openssl-devel bzip2-devel expat-devel gdbm-devel readline- 
devel sqlite*-devel mysql-devel 


完成 上 述 安 装 后 ， 我 们 使 用 wget 指令 在 Python 官网 下 载 Python 3.6 的 压缩 包 ， 
在 CentOS 7 系统 输入 下 载 指令 wget “https://www.python.org/ftp/python/3.6.3/Python- 
3.6.3.tgz”。 下 载 完成 后 ， 可 以 在 当前 路 径 查 看 下 载 的 内 容 ， 如 图 12-14 所 示 。 








图 12-14 下 载 的 内 容 


下 一 步 是 对 压缩 包 进 行 解压 ， 在 当前 路 径 下 输入 解压 指令 tar -zxvf Python- 
3.6.3.tgz。 解 压 完成 后 ， 在 当前 路 径 下 会 出 现 Python-3.6.3 文件 夹 ， 如 图 12-15 所 示 。 


EEC 


加 如 画 尹 司 辐 到 台电 加 se:caa 














型 12-15 Python-3.6.3 文件 夹 
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Python-3.6.3 文件 夹 是 我 们 需要 的 开发 环境 , 里 面包 含 Python 3.6 版 本 所 需 的 组 件 。 
最 后 将 Python-3.6.3 编译 到 CentOS 7 系统 ， 编 译 指令 如 下 : 


# 进入 Python-3.6.3 文件 夹 
cd Python-3.6.3 

# 依次 输入 编译 指令 

sudo ./configure 

make 

make install 


编译 完成 后 , 我 们 在 CentOS 7 系统 输入 指令 python 3, 即 可 进入 Python 交互 模式 ， 
如 图 12-16 所 示 。 





图 12-16 Python 3.6 的 交互 模式 


12.3 部 署 uUWSGI 服务 器 


uWSGI 是 一 个 Web 服务 器 ， 它 实现 了 WSGI、uWSGI 和 HTTP 等 协议 。Nginx 
中 HttpUwsgiModule 的 作用 是 与 UWSGI 服务 器 进行 交换 。WSGI 是 一 种 Web 服务 器 
网 关 接 口 ， 它 是 一 个 Web 服务 器 (如 Nginx 服务 器 ) 与 Web 应 用 (如 Django 框架 实 
现 的 应 用 ) 通信 的 一 种 规范 。 

在 部 署 WSGI 服务 器 之 前 ， 需 要 在 Python 3 中 安装 相应 的 模块 ， 我 们 使 用 pip3 
安装 即 可 ， 安 装 指令 如 下 : 




















Pip3 install mysqlclient 
Pip3 install django 
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pip3 install uwsgi 


安装 成 功 后 ， 打 开本 地 系统 的 项 目 music， 修 改 项 目的 配置 文件 ， 主 要 修改 数据 
库 连 接 信息 和 静态 资源 路 径 ， 修 改 代码 如 下 : 


# 数据 库 连接 信息 
DATABASES = { 
'default': { 
'ENGINE': 'django.db.backends.mysql', 
'NAME': 'music db', 
'USER':'root', 
'PASSWORD' : '1234"', 

# 改 为 本 地 系统 的 IP 地 址 
'HOST':'10.168.1.242', 
PORT":*3306"', 

3 


# 静态 资源 路 径 
STATIC ROOT = 'static/' 


下 一 步 使 用 FileZilla 将 本 地 系统 的 项 目 music 转移 到 虚拟 系统 CentOS 7， 项 目 
music 存放 在 虚拟 系统 的 home 文件 夹 中 ， 如 图 12-17 所 示 。 
































图 12-17 home 目录 结构 


完成 上 述 配置 后 ， 在 CentOS 7 系统 中 输入 uwsgi 指令 ， 测 试 WSGI 服务 器 能 否 
正常 运行 ， 指 令 如 下 : 


# /home/music 是 项 目 music 的 绝对 路 径 ，music.wsgi 是 项 目 music 里 面 的 wsgi .py 文件 


uwsgi --http :8080 --chdir /home/music -w music.wsgi 
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指令 运行 后 ， 可 以 在 本 地 系统 的 浏览 器 中 输入 虚拟 系统 的 他 地 址 +8080 端 














查 


看 测试 结构 。 在 本 地 系统 访问 http:/10.168.1.124:8080/， 浏 览 器 就 会 显示 项 目 music 


的 首页 信息 ， 如 图 12-18 所 示 。 





图 12-18 测试 uWSGI 服务 器 


uWSGI 服务 器 测试 成 功 后 ， 下 一 步 是 为 项 目 music 编写 uWSGI 配置 文件 。 当 项 
目 运行 上 线 时 ， 只 需 执行 wWSGI 配置 文件 即 可 运行 项 目 music 的 uWSGI 服务 器 。 在 


项 目 music 的 目录 下 创建 music_uwsgiini 配置 文件 ， 文 件 代 码 如 下 : 


[uwsgi] 
# Django-related settings 
socket= :8080 


# the base directory (full path) 
chdir=/home/music 


# Django s wsgi file 
module=music.wsgi 


# process-related settings 
# master 
master=true 


# maximum number of worker processes 
processes=4 


# ... with appropriate permissions - may be needed 
# chmod-socket = 664 

# clear environment on exit 

vacuum=true 





在 CentOS 7 系统 中 查看 项 目 music 的 目录 结构 ， 并 且 在 项 目 music 的 根 目 录 下 





输入 uwsgi 指令 ， 通 过 配置 文件 启动 WSGI 服务 器 ， 如 图 12-19 所 示 。 
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图 12-19 uWSGI 服务 器 











注意 : 因为 配置 文件 设置 socket= :8080， 所 以 启动 WSGI 服务 器 时 ， 本 地 系统 
不 能 浏览 项 目 music 的 首页 。 配 置 属性 socket= :8080 用 于 uWSGI 服务 器 和 Nginx 服 
务 器 的 通信 连接 。 


12.4 安装 Nginx 部 署 项 目 


一 

项 目 上 线 部 署 最 后 一 个 环节 是 部 署 Nginx 服务 器 。 由 于 CentOS 7 的 yam 没有 
Nginx 的 安装 源 ， 因 此 将 Nginx 的 安装 源 添 
服务 器 ， 指 令 如 下 : 





加 到 yum 中 ， 然 后 使 用 yum 安装 Nginx 


# 添加 Nginx 的 安装 源 

rpm -ivh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release- 
centos-7-0.el7. 

ngx.noarch.rpm 

# 使 用 yum 安装 Nginx 

yum install nginx 


Nginx 安装 成 功 后 ， 在 CentOS 7 上 输入 Nginx 启动 指令 systemctl start nginx， 然 
后 在 本 地 系统 的 浏览 器 中 输入 CentOS 7 系统 的 下 地 址 ， 可 以 看 到 Nginx 启动 成 功 ， 
如 图 12-20 所 示 。 
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12-20 启动 Nginx 


下 一 步 是 修改 Nginx 的 配置 文件 ， 实 现 Nginx 服务 器 与 UWSGI 服务 器 的 通信 连 
接 。 将 CentOS 7 系统 路 径 切 换 到 /etc/nginx/， 打 开 并 编辑 nginx.conf 文件 ， 在 nginx. 
conf 文件 中 编写 项 目 music 的 配置 信息 。 其 代码 如 下 : 


user nginx; 
worker processes 1; 


error log /var/log/nginx/error.l1og warn; 
pid /var/run/nginx.pid; 


events { 


worker_connections 1024; 


http { 
include /etc/nginx/mime.types; 
default type application/octet-stream; 
log format main '$remote addr - $remote user [$time locall] 
"$request" ' 
'$status $body bytes sent "$http referer" ' 
'"$http user agent" "$http x forwarded for"'; 


access log /var/log/nginx/access.log main; 


sendfile on; 
#tcp_nopush on; 


keepalive timeout 65; 


#gzip on; 
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include /etc/nginx/conf.d/*.conf; 
# 新 增 内 容 


server { 


listen 8090; 

server name 1275020:1 

charset UTF-8; 

access log /var/log/nginx/myweb access.1og7 
error log /var/log/nginx/myweb error.1og; 


client max body size 75M; 
# 连接 uWSGI 服务 器 ，uwsgi_pass 的 端口 与 uwsGI 设置 的 socket= :8080 端口 一 致 
location / { 
include uwsgi params; 
uwsgi pass 127.0.0.1:8080; 
uwsgi read timeout 2; 
} 
# 设置 静态 资源 
location /static/ { 
expires 30d; 





autoindex on; 
adqd header Cache-Control private; 
alias /home/music/static/; 


} 
# 新 增 内 容 
} 





完成 Nginx 的 相关 配置 后 ， 在 CentOS 7 系统 中 结束 Nginx 的 进程 或 重启 系统 ， 
确保 当前 系统 没有 运行 Nginx 服务 器 。 然 后 输入 Nginx 指令 ， 重 新 启动 Nginx 服务 器 ， 
Neginx 启动 后 ， 进 入 项 目 music， 使 用 uwsgi 指令 运行 music_ uwsgiini， 启 动 uWSGI 


服务 器 ， 如 图 12-21 所 示 。 





车 硬 罗 固 xiat cel 
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Neginx 月 


2.0 


及 务 器 和 uwuWSGI 服务 器 启动 后 ， 项 目 music 就 已 经 运行 上 线 。 在 本 地 系 
统 的 浏览 器 上 访问 http://10.168.1.124:8090/ 可 以 看 到 项 目 music 的 首页 信息 ， 地 址 端 











口 8090 是 











Nginx 服务 器 设置 的 。 运 行 结果 如 图 12-22 所 示 。 








12-22 项 目 运行 效果 


12.5 本 章 小 结 


目前 部 署 Diango 项 目 有 两 种 主流 方案 ,NginxtuWSGIHDiango 或 者 


ApachetuWSGI+Django。Nginx 作为 服务 器 最 前 端 ， 


负责 接收 浏览 器 的 所 有 请 求 并 统 


一 管理 。 静 态 请 求 由 Nginx 自己 处 理 ， 非 静态 请 求 通过 uWSGI 服务 器 传递 给 Django 
应 用 ， 由 Django 进行 处 理 并 做 出 响应 ， 从 而 完成 一 次 Web 请 求 。 

在 虚拟 机 上 安装 Linux 系统 需要 设置 虚拟 机 和 本 地 系统 之 间 的 网 络 通信 、Linux 
辅助 工具 的 安装 和 本 地 系统 与 虚拟 系统 的 文件 传输 设置 。 这 部 分 知识 属于 Linux 的 基 
本 知识 ， 如 果 读 者 在 实施 过 程 中 遇 到 其 他 问题 ， 可 以 自行 在 网 上 搜索 相关 解决 方案 。 




















在 不 删 


Python 版 本 。 














Python 3 使 


的 依赖 组 件 ， 否 则 会 导致 安装 失败 。 





uWSGI 






































自动 是 由 配置 文件 music_uwsgiini 执行 的 ， 其 作用 


用 进行 绑 定 。 





Nginx 服务 器 负责 接收 浏览 器 的 请 求 并 将 请 求 
nginx.conf 主要 实现 Nginx 服务 器 和 uWSGI 服务 器 
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除 旧版 本 Python 2 的 基础 上 安装 Python 3 版 本 ， 实 现 一 个 系统 共存 两 个 
安装 Python 3 之 前 必须 安装 Linux 的 wget 工具 、GCC 编译 器 环境 以 及 








及 务 器 是 由 Python 编写 的 服务 器 ， 由 uwsgi 模块 实现 。uWSGI 服务 器 的 











是 将 uWSGI 服务 器 与 Django 应 


传递 给 uWSGI 服务 器 。 配 置 文件 





的 通信 连接 。 


第 三 方 功 能 应 用 


在 前 面 的 章节 中 ， 我 们 主要 讲述 Django 框架 的 内 置 功能 以 及 使 用 方法 ， 而 本 章 
主要 讲述 Django 的 第 三 方 功能 应 用 以 及 使 用 方法 。 通 过 本 章 的 学 习 ， 读 者 能 够 在 网 
站 开发 过 程 中 快速 开发 网 站 API、 生 成 网 站 验证 码 、 实 现 搜索 引擎 、 实 现 第 三 方 用 户 
注册 和 分 布 式 任务 。 


13.1 快速 开发 网 站 API 


网 站 API 也 称 为 接口 ， 接 口 其 实 与 网 站 的 URL 地 址 是 同一 个 原理 。 当 用 户 使 用 
GET 或 者 POST 方式 访问 接口 时 ， 接 口 以 JSON 或 字符 串 的 数据 内 容 返 回 给 用 户 ， 这 
与 网 站 的 URL 地 址 返回 的 数据 格式 有 所 不 同 ， 网 站 的 URL 地 址 主要 返回 的 是 HTML 
网 页 信息 。 
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若 想 快 速 开发 网 站 API， 可 以 使 用 Django Rest 
Framework 框架 实现 。 使 用 框架 开发 可 以 规范 代码 的 
编写 格式 ， 这 对 企业 级 开发 来 说 很 有 必要 ， 上 毕竟 每 个 
开发 人 员 的 编程 风格 存在 一 定 的 差异 ， 开 发 规范 化 可 
以 方便 其 他 开发 人 员 查看 和 修改 。 在 使 用 Django Rest 
Framework 之 前 ， 首 先 安装 Django Rest Framework 框 
架 ， 建 议 使 用 pip 完成 安装 ， 安 装 指令 如 下 : 


pip install djangorestframework 


框架 安装 完成 后 ， 以 MyDiango 项 目 为 例 ， 在 
项 目 应 用 index 中 创建 serializers.py 文件 ， 用 于 定义 
Django Rest Framework 的 Serializer 类 。MyDjango 目 
录 结 构 如 图 13-1 所 示 。 


v Bindex 

> Ba migrations 
般 _init_py 
船 adminpy 
般 appspy 
也 modelspy 
及 serializers.py 
器 tests.py 
亩 udspy 
访 viewspy 











>》 lh External Libraries 


图 13-1 MyDjango 目录 结构 





构建 项 目 目录 后 ， 接 着 在 settings.py 中 设置 相关 配置 信息 。 在 settings.py 中 分 别 
设置 数据 库 连接 信息 和 Django Rest Framework 框架 的 功能 配置 ， 配 置 代码 分 别 如 下 : 


# 数据 库 连接 方式 
DATABASES = { 
'default': { 
'ENGINE': 'django.db.backends.mysql', 
'NAME': 'mydjango', 
USER': "root"; 
'PASSWORD': '1234°', 
"OSP's "12700051"5 
'PORT': '3306', 


} 


# Django Rest Framework 框架 的 配置 信息 
INSTALLED APPS = [ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'index', 
# 添加 Django Rest Framework 框架 
'rest framework" 
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# Django Rest Framework 框架 的 配置 信息 


# 分 页 设置 
REST FRAMEWORK = { 
"DEFAULT PAGINATION CLASS': 'rest framework.pagination. 


PageNumberPagination', 
# 每 页 显示 多 少 条 数据 
'PAGE SIZE': 2 
} 


上 述 代 码 中 ， 不 再 对 数据 库 配 置 做 详细 的 讲述 ， 我 们 主要 分 析 Django Rest 
Framework 的 功能 配置 。 


(1) 在 INSTALLED APPS 中 添加 功能 配置 ， 这 样 能 使 Django 在 运行 过 程 中 自 
动 加 载 Django Rest Framework 的 功能 。 


(2) 配置 REST FRAMEWORK 属性 ， 属 性 值 以 字典 的 形式 表示 ， 用 于 设置 
Dijango Rest Framework 的 分 页 功能 。 


完成 settings.py 的 配置 后 ， 下 一 步 是 定义 项 目的 数据 模型 。 在 index 的 models.py 
中 分 别 定义 模型 Type 和 Product， 代 码 如 下 : 


# 在 index 的 models .py 中 定义 模型 
from django.db import models 
# 产品 分 类 表 
class Type (models.Model): 
id = models.AutoField(' 序 号 ',， primary_key=True) 
type_name = models.CharField(' 产品 类 型 '，max_length=20) 
# 设置 返回 值 
def _str (self): 
return self.type name 


# 产品 信息 表 

class Product (models.Model): 
id = models.AutoField(' 序号 '， primary_ key=True) 
name = models.CharField(' 名 称 ' max length=50) 
weight = models.CharField(' 重量 ',max_length=20) 
size = models.CharField(' 尺寸 max length=20) 
type = models.ForeignKey (Type, on_ delete=models.CASCADE,verbose_ 

name=' 产品 类 型 ') 
# 设置 返回 值 
def _ str {seif): 
return self.name 


将 定义 好 的 模型 执行 数据 迁移 ， 在 项 目的 数据 库 中 生成 相应 的 数据 表 ， 并 对 数据 
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表 index product 和 index type 导入 数据 内 容 ， 如 图 13-2 所 示 。 
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13-2 数据 表 的 数据 信息 


上 述 基 本 配置 完成 后 ， 接 下 来 使 用 Django Rest Framework 快速 开发 API。 首 先 在 
项 目 应 用 index 的 serializers.py 中 分 别 定 义 Serializer 类 和 ModelSerializer 类 , 代码 如 下 : 


from rest framework import serializers 
from .models import Product, Type 
# 定义 Serializer 类 
# 设置 下 拉 内 容 
type_id = TYPe.objects.values('id').all() 
TYPE_CHOICES = [item['id'] for item in type id] 
class MySerializer (serializers.Serializer): 
id = serializers.IntegerField(read only=True) 
name = serializers.CharField (required=True, allow blank=False, max_ 
length=100) 
weight = serializers.CharField (required=True, allow blank=False, max_ 
length=100) 
size = serializers.CharField (required=True, allow blank=False, max_ 
length=100) 
type 


ll 


serializers.ChoiceField (choices=TYPE CHOICES, default=1) 


# 重 写 create 函数 ， 将 API 数据 保存 到 数据 表 index_product 
def create(self, validated data): 
return Product.objects.create(**validated data) 


# 重 写 update 函数 ， 将 API 数据 更 新 到 数据 表 index_product 

def update (self, instance, validated data): 
instance.name = validated data.get ('name', instance.name) 
instance.weight = validated data.get ('weight', instance.weight) 


212 


第 13 章 第 三 方 功能 应 用 


instance.size = validated data.get('size', instance.size) 
instance.type = validated data.get('type', instance.type) 
instance.save() 
return instance 


# 定义 Modelserializer 类 
class ProductSerializer (serializers.ModelSerializer): 
class Meta: 
model = Product 
fields = ' all '" 


# fields = ('id', 'name', 'weight', 'size', 'type') 


从 上 述 代 码 可 以 看 到 ，Serializer 类 和 ModelSerializer 类 与 Django 的 表单 
Form 类 和 ModelForm 类 非常 相似 ， 两 者 的 定义 可 以 相互 借鉴 。 此 外 ，Serializer 和 
ModelSerializer 还 有 其 他 函数 方法 ， 若 想 进 一 步 了 解 ， 在 Python 的 安装 目录 中 查看 相 
应 的 源 文件 (\Lib\site-packages\rest_framework) 。 最 后 ， 在 urls.py 和 views.py 中 实现 
API 开发。 以 定义 的 ProductSerializer 类 为 例 ，API 功能 代码 如 下 : 


# index 的 urls.py 

from django .ur1ls import path 

from . import views 

urlpatterns = [ 
# 基于 类 的 视图 
path('', views.product class.as view()), 
# 基于 函数 的 视图 


path('<int:pk>', views.product def), 


# index 的 views.py 
from .models import Product 
from .serializers import ProductSerializer 


# APIView 方式 生成 视图 
from rest framework.views import APIView 
from rest framework.response import Response 
from rest framework import status 
from rest framework.pagination import PageNumberPagination 
class product class (APIView): 
# get 请 求 
def get (self, request): 
queryset = Product.objects.all () 
# 分 页 查询 ， 需 要 在 settings .py 中 设置 REST_FRAMEWORK 属性 
pg = PageNumberPagination() 
page roles = pg.paginate queryset (queryset=queryset, 
request=request, view=self) 
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serializer = ProductSerializer(instance=page roles, many=True) 
# serializer = ProductSerializer (instance=queryset, many=True) 二 


全 表 查 询 
# 返回 对 象 Response 由 Django Rest Framework 实现 
return Response (serializer.data) 
# post 请 求 
def post(self, request): 
# 获取 请 求 数据 
serializer = ProductSerializer (data=request.data) 
# 数据 验证 
if serializer.is valid(): 
# 保存 到 数据 库 
serializer.save() 
# 返回 对 象 Response 由 Django Rest Framework 实现 ，status 用 于 设置 响 
应 状态 码 
return Response (serializer.data, status=status.HTTP 201 
CREATED) 
return Response(serializer.errors, status=status.HTTP 400 BRD 
REQUEST) 


# 普通 函数 方式 生成 视图 
from rest framework.decorators import api view 
@api view(['GET', 'POST']) 
def product def (request, pk): 
if request.method == 'GET': 
queryset = Product.objects .filter (id=pk) .all () 
serializer = ProductSerializer (instance=queryset, many=True) 
# 返回 对 象 Response 由 Django Rest Framework 实现 
return Response (serializer.data) 


elif request.method == '‘'POST': 
# 获取 请 求 数据 
serializer = ProductSerializer (data=request .data) 
# 数据 验证 
if serializer.is valid(): 
# 保存 到 数据 库 


serializer.save() 
# 返回 对 象 Response 由 Django Rest Framework 实现 ，status 用 于 设置 响 


应 状态 码 
return Response(serializer.data, status=status.HTTP 201_ 
CREATED) 
return Response (serializer.errors, status=status.HTTP 400 BAD_ 
REQUEST) 


在 分 析 上 述 代码 之 前 ， 首 先 了 解 一 下 Django Rest Framework 实现 API 开发 的 三 
种 方法 : 
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。 基于 类 的 视图 。 
e 基于 函数 的 视图 。 
@ 重 构 ViewSets 类 。 


其 中 ， 重 构 ViewSets 类 的 实现 过 程 过 于 复杂 ， 在 开发 过 程 中 ， 如 无 必要 ， 一 般 
不 建议 采用 这 种 实现 方式 。 若 读者 对 此 方法 感 兴趣 ， 可 以 参考 官方 文档 (http://www. 
django-rest-framework.org/tutorial/6-viewsets-and-routers/) 。 

在 views.py 中 定义 的 product_class 类 和 函数 product def 分 别 基于 类 的 视图 和 基 
于 函数 的 视图 ， 两 者 的 使 用 说 明 如 下 。 

(1) 基于 类 的 视图 : 开发 者 主要 通过 自 定义 类 来 实现 视图 ， 自 定义 类 可 以 

选择 继承 父 类 APIView、mixins 或 generics。APIView 类 适用 于 Serializer 类 和 
ModelSerializer 类 ，mixins 类 和 generics 类 只 适用 于 ModelSerializer 类 。 

上 述 代码 的 product_ class 类 主要 继承 APIView 类 ， 并 且 定 义 GET 请 求 和 POST 
请 求 的 处 理 函 数 。GET 函数 主要 将 模型 Product 的 数据 进行 分 页 显示 ，POST 函数 
将 用 户 发 送 的 数据 进行 验证 并 入 库 处 理 。 启 动 MyDjango 项 目 ， 在 浏览 器 上 输入 
http://127.0.0.1:8000/?page=1， 运 行 结果 如 图 13-3 所 示 。 


Product Class 





图 13-3 GET 请 求 的 响应 内 容 


为 了 进一步 验证 POST 函数 是 否 正确 ， 我 们 在 项 目的 目录 外 创建 testpy 文件 ， 文 
件 代 码 如 下 : 


import requests 
url = 'http://127.0.0.1:8000' 
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data = { 
"name': "MyPhone', "weight"': "123G', '"'size': '123*123', 'type': 1 
} 
r= requests.post(url, data=data) 
print(r.text) 


运行 test.py 文件 并 查看 数据 表 index product， 可 以 发 现 数据 表 index product 新 
增 一 条 数据 信息 ， 如 图 13-4 所 示 。 


文人 多 关 下 在 章 D 。 帮助 
好 Fe 务 国名 主 - 可 5 和 与 # 订 国 SA 轩 Sd 
id weight size 

157.00"74.98"6.97mm 
156.9"75.1"7.5mm 
248"173"7.8mm 
229.8"159.8"7.95 mm 
45°48.3"12.6 
44"19.7"103mm 
139"73.7"15.5mm 
300"300°23,7mm 
120"75"7mm 
120°"75"77mm 
120"75"Tmm 
157.00"74.98"6.97mm 


Y 
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图 13-4 POST 请 求 的 处 理 结果 





(2) 基于 函数 的 视图 : 使 用 函数 的 方式 实现 API 开 发 是 三 者 中 最 为 简单 的 方式 ， 

从 函数 product def 的 定义 来 看 ， 该 函数 与 Django 定义 的 视图 函数 并 无 太 大 区 别 。 
唯一 的 区 别 在 于 函数 product def 需要 使 用 装饰 器 api_view 并 且 数 据 是 由 Django Rest 
Framework 定义 的 对 象 进行 返回 的 。 

上 述 代码 中 ， 若 用 户 发 送 GET 请 求 ， 函 数 参数 pk 作为 模型 Product 的 查询 条 
件 ， 查 询 结果 交 给 ProductSerializer 类 实例 化 对 象 serializer 进行 数据 格式 转换 ， 最 后 
由 Django Rest Framework 的 Response 对 象 返 回 给 用 户 ; 若 用 户 发 送 POST 请 求 ， 函 
数 将 用 户 发 送 的 数据 进行 验证 并 入 库 处 理 。 在 浏览 器 上 输入 http:/127.0.0.1:8000/2， 
运行 结果 如 图 13-5 所 示 。 
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Product Def 





图 13-5 GET 请 求 的 响应 内 容 


若 想 验证 POST 请求 的 处 理 方式 ， 只 需 将 上 述 testpy 的 ul 变量 改 为 
http://127.0.0.1:8000/1， 然 后 运行 test.py 文件 并 查看 数据 表 index_product 是 否 新 增 一 
条 数据 。 


Django Rest Framework 框架 的 使 用 方式 总 结 如 下 : 


(1) 在 settings.py 中 添加 Django Rest Framework 功能 ， 并 对 功能 进行 分 页 配置 。 
(2) 在 App 中 新 建 serializers.py 文件 并 定义 Serializer 类 或 ModelSerializer 类 。 
(3) 在 urlspy 中 定义 路 由 地 址 。 


(4) 在 views.py 中 定义 视图 函数 ， 三 种 定义 方式 分 别 为 : 基于 类 的 视图 、 基 于 
函数 的 视图 和 重 构 ViewSets 类 。 


13.2 验证 码 的 使 用 


现在 很 多 网 站 都 采用 验证 码 功能 ， 这 是 反扑 虫 常用 的 策略 之 一 。 目 前 常用 的 验证 
码 类 型 如 下 。 





e 字符 验证 码 : 在 图 片上 随机 产生 数字 、 英 文字 母 或 汉字 ， 一 般 有 4 位 或 者 6 
位 验证 码 字 符 。 

ee ”图片 验 证 码 : 图 片 验 证 码 采 用 字符 验证 码 的 技术 ， 不 再 使 用 随机 的 字符 ， 而 
是 让 用 户 识别 图 片 ， 比 如 12306 的 验证 码 。 

e ”GIF 动画 验证 码 : 由 多 张 图 片 组 合 而 成 的 动态 验证 码 ， 使 得 识别 器 不 容易 辨识 
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哪 一 张 图 片 是 真正 的 验证 码 图 片 。 

e。 极 验 验证 码 : 在 2012 年 推出 的 新 型 验证 码 ， 采 用 行为 式 验证 技术 ， 通 过 拖 动 
滑 块 完成 拼图 的 形式 实现 验证 ， 是 目前 比较 有 创意 的 验证 码 ， 安 全 性 具有 新 
的 突破 。 

e 手机 验证 码 : 通过 短信 的 形式 发 送 到 用 户 手 机 上 面 的 验证 码 ， 一 般 为 6 位 的 
数字 。 

。 语音 验证 码 : 也 属于 手机 端 验 证 的 一 种 方式 。 

”视频 验证 码 : 视频 验证 码 是 验证 码 中 的 新 秀 ， 在 视频 验证 码 中 ， 将 随机 数字 、 
字母 和 中 文 组 合 而 成 的 验证 码 动态 嵌入 MP4、FLYV 等 格式 的 视频 中 ， 增 大 破 
解难 度 。 


如 果 想 在 Django 中 实现 验证 码 功 能 ， 可 以 使 用 PIL 模块 生成 图 片 验证 码 ， 但 不 
建议 使 用 这 种 实现 方式 。 除 此 之 外 ， 还 可 以 通过 第 三 方 应 用 Django Simple Captcha 来 
实现 ， 验 证 码 的 生成 过 程 由 该 应 用 自动 执行 ， 开 发 者 只 需 考虑 如 何 应 用 到 Django 项 
目 中 即 可 。Django Simple Captcha 使 用 pip 安装 ， 安 装 指令 如 下 : 


pip install django-simple-captcha 


安装 成 功 后 ， 下 一 步 讲 述 如 何在 Django 中 使 用 Django Simple Captcha 生成 网 站 
验证 码 。 以 MyDjango 项 目 为 例 ， 在 项 目 中 应 用 user 创建 templates 文件 夹 和 forms.py 
文件 ， 最 后 在 templates 文件 夹 中 放置 userhtml 文件 ， 目 录 结 构 如 图 13-6 所 示 。 














13-6 MyDjango 目录 结构 


项 目 目录 搭建 后 ， 接 下 来 在 settings.py 中 配置 项 目 。 除 了 项 目的 基本 配置 之 外 ， 
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如 果 要 配置 TEMPLATES 和 DATABASES， 还 可 以 对 验证 码 的 生成 进行 配置 ， 如 设置 
验证 码 的 内 容 、 图 片 噪 点 和 图 片 大 小 等 。 具 体 的 配置 信息 如 下 : 


INSTRALLED APPS = [ 
'django.contrib.admin', 
"django .contrib-auth'v 
'django.contrib.contenttypes', 
"django .contrib.sessions'yv 
"django .contrib.messages'v 
"django .contrib.staticfiles'v 
"user'v 
# 添加 验证 码 功能 
"captcha'" 


] 


# django_simple_captcha 验证 码 基本 配置 
# 设置 验证 码 的 显示 顺序 ， 一 个 验证 码 识别 包含 文本 输入 框 、 隐 藏 域 和 验证 码 图 片 ， 该 配置 用 于 设 
置 三 者 的 显示 顺序 
CAPTCHA OUTPUT FORMAT = '%(text _ field)s %(hidden field)s %(image)s' 
# 设置 图 片 噪点 
CAPTCHA_NOISE_FUNCTIONS = (# 设置 样式 
'captcha.helpers.noise null', 


# 设置 干扰 线 
'captcha.helpers.noise arcs', 
# 设置 干扰 点 
'captcha.helpers.noise dots') 

# 图 片 大 小 

CAPTCHA IMAGE SIZE = (100, 25) 

# 设置 图 片 背景 颜色 


CAPTCHA BACKGROUND COLOR = '#ffffff" 
# 图 片 中 的 文字 为 随机 英文 字母 ， 如 mdsh 


# CAPTCHA CHALLENGE FUNCT = 'captcha.helpers.random char challenge' 
# 图 片 中 的 文字 为 英文 单词 

# CAPTCHA CHALLENGE FUNCT = 'captcha.helpers.word challenge' 

# 图 片 中 的 文字 为 数字 表达 式 ， 如 1+2=</span> 

CAPTCHA CHALLENGE FUNCT = 'captcha.helpers.math challenge' 

# 设置 字符 个 数 


CAPTCHA LENGTH = 4 
# 设置 超时 (minutes) 
CAPTCHA TIMEOUT = 1 


首先 在 INSTALLED_ APPS 中 添加 captcha 验证 码 功 能 ， 项 目 运 行 时 会 自动 加 载 
captcha 功能 。 然后 对 captcha 功能 进行 相关 的 配置 , 主要 的 配置 有 : 验证 码 的 显示 顺序 、 
图 片 噪点 、 图 片 大 小 、 背 景 颜色 和 验证 码 内 容 ， 有 具体 的 配置 以 及 配置 说 明 可 以 查看 源 
代码 及 注释 。 
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完成 上 述 配置 后 ， 下 一 步 是 执行 数据 迁移 。 在 功能 配置 后 必须 执行 数据 迁移 ， 
为 验证 码 需要 依赖 数据 表 才 能 得 以 实现 。 通 过 python manage.py migrate 指令 完成 数 
据 迁 移 ， 然 后 查看 项 目 所 生成 的 数据 表 ， 发 现 新 增 数 据 表 captcha_captchastore， 如 图 
13-7 所 示 。 





上 auth_group 

上 auth_group_permissions 
auth_permission 
auth_user 

寺 auth_user_groups 
Hauth_user_user_permissions 
用 captcha_captchastore 
django_admin_log 
django_content type 

团 django_migrations 

团 django_session 


图 13-7 项 目的 数据 表 























接 下 来 将 验证 码 功能 生成 在 网 页 上 并 实现 验证 功能 。 下 面 以 实现 带 验证 码 的 用 户 
登录 为 例 进行 介绍 ， 根 据 整 个 用 户 登录 过 程 ， 我 们 将 其 划分 为 多 个 不 同 的 功能 。 


。 用户 登录 界面 : 由 表单 生成 ， 表 单 类 在 项 目 应 用 user 的 forms.py 中 定义 。 
e “登录 验证 : 触发 POST 请求 ， 用 户 信息 以 及 验证 功能 由 Django 内 置 的 Auth 认 
9 ”验证 码 动 态 刷新 由 Ajax 方式 向 captcha 功能 应 用 发 送 GET 请 求 完成 动态 刷新 。 
。 ”验证 码 动 态 验证 ， 由 Ajax 方式 向 Django 发 送 GET 请 求 完成 验证 码 验 证 。 


根据 上 述 功 能 进行 分 析 ， 整 个 用 户 登 录 过 程 由 MyDjango 的 urls.py 和 项 目 应 用 
user 的 forms.py、urls.py、views.py 和 userhtml 共同 实现 。 首 先 在 项 目 应 用 user 的 
forms.py 中 定义 用 户 登 录 表 单 类 ， 代 码 如 下 : 


# 定义 用 户 登录 表单 类 

from django import forms 

from captcha.fields import CaptchaField 

class CaptchaTestForm(forms.Form): 
username = forms .CharField(label=' 用 户 名 ') 
password = forms.CharField (label=" 密码 '， widget=forms.PasswordInput) 
captcha = CaptchaField() 


从 表单 类 CaptchaTestForm 可 以 看 到 ， 字 段 captcha 是 由 Django Simple Captcha 
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定义 的 CaptchaField 对 象 ， 该 对 象 在 生成 HIML 网 页 信息 时 ， 将 自动 生成 文本 输入 
框 、 隐 藏 域 和 验证 码 图 片 。 然 后 表单 类 在 views.py 中 进行 实例 化 并 展示 在 网 页 上 ， 在 
MyDjango 的 urlspy 和 项 目 应 用 user 的 urlspy、viewspy 和 userhtml 中 分 别 编写 以 下 
代码 : 


# MyDjango 的 urls.py 
from django.contrib import admin 
from django.urls import path,include 
urlpatterns = [ 
path('admin/', admin.site.urls), 
path('', include('user.urls')), 
# 导入 captcha 功能 应 用 的 URL 地 址 信息 ， 用 于 生成 图 片 地 址 
path('captcha/', include('captcha.urls')) 


# 项 目 应 用 user 的 urls.py 

from django.urls import path 

from . import views 

urlpatterns = [ 
# 用 户 登录 界面 
path('', views.loginView, name='login'), 
# 验证 码 验证 API 接口 


path('ajax val', views.ajax val, name='ajax val') 


# 项 目 应 用 user 的 views.py 
from django.shortcuts import render 
from django.contrib.auth.models import User 
from django.contrib.auth import login, authenticate 
from .forms import CaptchaTestForm 
# 用 户 登录 
def loginView (request): 
if request.method 1POST' : 
form = CaptchaTestForm(request .POST) 





# 验证 表单 数据 
if form.is Valid() : 
username = form.cleaned _ data['username'] 


password = form.cleaned data['password'] 
if User.objects .filter (username=username): 
user = authenticate (username=username, password=password) 
if user: 
if user.is active: 
login(request, user) 
tips = ，' 登录 成 功 ' 


else: 
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tips = ' 账号 密码 错误 ， 请 重新 输入 ' 
Le 
tips = ' 用 户 不 存在 ， 请 注册 ' 
else: 
form = CaptchaTestForm() 
return render(request, ‘user.html', locals()) 


# ajax 接口 ， 实 现 动 态 验证 验证 码 
from django.http import JsonResponse 
from captcha.models import Captchastore 
def ajax val (request): 
if request.is ajax(): 
# 用 户 输入 的 验证 码 结果 
response = request.GET['response'] 
# 隐藏 域 的 value 值 
hashkey = request.GET['hashkey'] 
cs = Captchastore.objects .filter (response=response, 
hashkey=hashkey) 
# 车 存在 cs， 则 验证 成 功 ， 否 则 验证 失败 
if cs: 
json data = {'status':1} 
else: 
json data = {'status':0} 
return JsonResponse (json data) 
else: 
json data = {'status':0} 
return JsonResponse (json data) 


# 项 目 应 用 user 的 user.html 
<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="UTF-8" /> 
<title>Django</title> 
<script src="http://apps.bdimg.com/libs/jquery/2.1.1/jquery.min. 
js"></script> 
<link rel="stylesheet" href="https://unpkg.com/mobi.css/dist/ 
mobi.min.css"> 
</head> 
<body> 
<div class="flex-center"> 
<div class="container"> 
<div class="flex-center"> 





<div class="unit-1-2 unit-1I-on-mobile"> 
<hl>MyDjango Verification</h1l> 
{$$ if tips %$} 
<div>{{ tips }}</div> 
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{$$ endif %} 
<form class="form" action="" method="post"> 
{$$ csrf token %} 
<div> 用 户 名 :{{ form.username }}</div> 
<div> 密 码 :{{ form.password }}</div> 
<div> 验证 码 :{{ form.captcha }}</div> 
<button type="submit" class="btn btn-primary btn-— 
block"> 确定 </button> 
</form> 
</div> 
</div> 
</div> 
</div> 
<script> 
$ (function(){ 
{# ajax 刷新 验证 码 #} 
$('.captcha') .click (function(){ 
console.log('click'); 
$.getJSON("/captcha/refresh/", 
function(result){ 
$('.captcha') .attr('src', result['image url']); 
$('#id captcha 0') .val(result['key']) 
1) 721); 
{# ajax 动态 验证 验证 码 #} 
$('#id captcha 1').blur(function()1{ 
// #id_captcha_1 为 输入 框 的 id， 当 该 输入 框 失 去 焦点 时 就 会 触发 函数 
json data={ 
// 获取 输入 框 和 隐藏 字段 id_captcha_0 的 数值 
"response':$('#id_captcha 1') .val()v 
'hashkey':$('#id captcha 0') .val() 
} 
$.getJSON('/ajax val', json data, function(data){ 
$('#captcha_status') .remove () 
//status 返回 1 为 验证 码 正确 ， status 返回 0 为 验证 码 错误 ， 在 输 
入 框 的 后 面 写 入 提示 信息 
if(data['status']){ 
$('#id captcha 1').after('<span id="captcha_ 
status">* 验证 码 正确 </span>') 
jelse{ 
$('#id captcha 1').after('<span id="captcha_ 
status">* 验证 码 错误 </span>') 


Ds; 
}) 


</script> 
</body> 
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</html> 
上 述 代码 用 于 实现 整个 用 户 登 录 过 程 ， 代 码 中 具体 实现 的 功能 说 明 如 下 。 


(1) MyDjango 的 urlspy: 引入 Django Simple Captcha 的 urlspy 和 项 目 应 用 
user 的 urlspy。 前 者 主要 为 验证 码 图 片 提供 URL 地 址 以 及 为 Ajax 动态 刷新 验证 码 提 
供 API 接口 ， 后 者 用 于 设置 用 户 登录 界面 的 URL 以 及 为 Ajax 动态 校 验证 码 提供 API 
接口 。 

(2) 项 目 应 用 user 的 urlspy: 设置 用 户 登 录 界 面 的 URL 地 址 和 Ajax 动态 验证 
的 API 接口 。 

(3) views.py: 函数 loginView 使 用 Django 内 置 的 Auth 实现 登录 功能 ， 函 数 
ajax_val 用 于 获取 Ajax 的 GET 请 求 参数 ， 然 后 与 Django Simple Captcha 定义 的 模型 
进行 匹配 ， 若 匹配 得 上 ， 则 验证 成 功 ， 否 则 验证 失败 。 

(4) user.html: 生成 用 户 表单 以 及 实现 Ajax 的 动态 刷新 和 动态 验证 功能 。Ajax 
动态 刷新 是 向 Django Simple Captcha 的 urlspy 所 定义 的 URL 发 送 GET 请 求 ， 而 
Ajax 动态 验证 是 向 项 目 应 用 user 的 urls.py 所 定义 的 URL 发 送 GET 请 求 。 


为 了 更 好 地 验证 上 述 所 实现 的 功能 ， 首 先 在 项 目 内置 User 的 中 创建 用 户 root 并 
启动 MyDjango 项 目 ， 然 后 执行 以 下 验证 步骤 ; 
(1) 单 击 验证 码 图 片 ， 查 看 验证 码 图 片 是 否 发 生 蔡 换 。 


(2) 单 击 验证 码 输入 框 ， 分 别 输入 正确 和 错误 的 验证 码 ， 然 后 单 击 网 页 的 其 他 
地 方 , 使 验证 码 输 入 框 失去 焦点 ， 从 而 触发 Ajax 请 求 , 最 后 查看 验证 码 验证 是 否 正确 。 


(3) 输入 用 户 的 账号 、 密 码 和 验证 码 ， 查 看 是 否 登 录 成 功 。 


13.3 站 内 搜索 引擎 


站 内 搜索 是 网 站 常用 的 功能 之 一 , 其 作用 是 方便 用 户 快速 查找 站 内 数据 以 便 查阅 。 
对 于 一 些 初学 者 来 说 ， 站 内 搜索 可 以 使 用 SQL 模糊 查询 实现 ， 从 菜 个 角度 来 说 ， 这 
种 实现 方式 只 适用 于 个 人 小 型 网 站 ， 对 于 企业 级 的 开发 ， 站 内 搜索 是 由 搜索 引擎 实现 
的 。 
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Django Haystack 是 一 个 专门 提供 搜索 功能 的 Django 第 三 方 应 用 ， 它 支持 Solr、 
Elasticsearch、Whoosh 和 Xapian 等 多 种 搜索 引擎 ， 配 合 著名 的 中 文 自然 语言 处 理 库 
jieba 分 词 可 以 实现 全 文 搜索 系统 。 

本 节 在 Whoosh 搜索 引擎 和 jieba 分 词 的 基础 上 使 用 Django Haystack 实现 网 站 搜 
索引 擎 。 因 此 ， 在 安装 Django Haystack 的 过 程 中 ， 需 要 自行 安装 Whoosh 搜索 引擎 和 
jieba 分 词 ， 具 体 的 pip 安装 指令 如 下 : 

pip install django-haystack 


pip install whoosh 
pip install jieba 


完成 上 述 模块 的 安装 后 ， 接 着 在 MyDjango 项 目 中 配置 相关 的 应 用 功能 。 在 项 目 
应 用 index 中 分 别 添加 文件 product_text.txt、search.html、search_indexes.py、whoosh_ 
cn_backend.py 和 文件 夹 static， 各 个 文件 说 明 如 下 。 


(1) product texttxt: 搜索 引擎 的 索引 模板 文件 ， 模 板 文件 命名 以 及 路 径 有 固定 
的 设置 格式 ， 如 /templates/search/indexes/ 项 目 应 用 的 名 称 / 模型 (小 写 )_text.txt。 


(2) search.html: 搜索 页 面 的 模板 文件 ， 用 于 生成 网 站 的 搜索 页 面 。 
(3) search indexes.py: 定义 索引 类 ， 该 文件 与 索引 模板 文件 是 两 个 不 同 的 概念 。 


(4) whoosh_cn backendpy: 这 是 自 定义 的 Whoosh 搜 索引 擎 文件 。 由 于 
Whoosh 不 支持 中 文 搜索 ， 因 此 需要 重新 定义 Whoosh 


MyDjango 上 








搜索 引擎 文件 ， 将 jieba 分 词 器 添加 到 搜索 引擎 中 ， 使 | “Sw 
得 它 具 有 中 文 搜索 功能 。 > ee 
(5) static: 存放 网 页 样式 common.css 和 search. es 昌 。 
Csso EE i 
总 search.html 
根据 上 述 目录 搭建 ， 最 后 MyDjango 的 目录 结构 人 
如 图 13-8 所 示 。 es 
MyDjango 目录 搭建 完成 后 ， 下 一 步 是 在 settings. 本 
py 中 配置 第 三 方 应 用 Django Haystack。 这 里 的 配置 主 ee 
要 在 INSTALLED APPS 中 引入 Django Haystack 以 及 | 、， 篇 woohmbeckendpy 
设置 该 应 用 的 功能 配置 ， 具 体 的 配置 信息 如 下 : Bea 








图 13-8 MyDjango 的 目录 结构 
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INSTRALLED APPS = [ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'index', 
# 配置 haystack 
"haystack'v 
# 配置 haystack 
HAYSTACK CONNECTIONS = { 
'default': { 
# 设置 搜索 引擎 ， 文 件 是 index 的 whoosh_cn backend.py 
"ENGINE ' : "index-whoosh_cn backend.WhooshEngine' 
"PRTH': os.path.join(BASE DIR, 'whoosh index'), 
'INCLUDE SPELLING': True, 
}, 
} 
# 设置 每 页 显示 的 数据 量 
HAYSTACK_ SEARCH RESULTS PER PAGE = 4 
# 当 数 据 库 改变 时 ， 会 自动 更 新 索引 ， 非 常 方便 
HAYSTACK_SIGNAL PROCESSOR = "haystack.signals.RealtimeSignalProcessor' 


观察 上 述 配 置 可 以 发 现 ， 配 置 属性 HAYSTACK_CONNECTIONS 的 ENGINE 指 
向 项 目 应 用 index 的 whoosh_cn backend.py 文件 。 该 文件 是 自 定义 的 Whoosh 搜索 引 
敬文 件 ， 这 是 根据 Whoosh 源 文件 进行 修改 生成 的 ， 在 Python 的 安装 目录 中 可 以 找到 
Whoosh 源 文 件 whoosh_backend.py， 如 图 13-9 所 示 。 








着 这 台电 脑 ， 李 地 碟 盘 (E) ， Python ， Lib ，site-packages ，haystack ，backends v6 
-| 修改 日 大 小 
| pycache— 2018/6/26 1203 。 文件 交 
Bjint_py 2017/5/25 617 python File 36 KB 
BB elasticsearch_backend.py 2018/3/30 20:46 = Python File 38 KB 
BB elasticsearch2 backend.py 2018/1/113:08 -Python Fle 14KB 
BB simple_backend.py 2016/1/1122:42 Python File SKB 
BB solr_backend.py 2018/3/30 2046 Python File 33 KB 
[B whoosh backend.py 2018/1/11 3:07 Python Fle ET 




















13-9 Whoosh 的 文件 路 径 


打开 whoosh backend.py 文件 并 将 内 容 复制 到 whoosh_cn backendpy， 然 后 将 复 
制 后 的 内 容 进 行 修 改 和 保存 ， 这 样 就 可 以 生成 自 定 义 的 Whoosh 搜索 引擎 文件 。 有 具体 
修改 的 内 容 如 下 : 
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# 引入 jieba 分 词 器 的 模块 


from jieba.analyse import ChineseAnalyzer 


# 找到 schema fields [field class.index fieldname] = TEXT... 所 在 位 置 并 修改 整 行 代 
码 ， 修 改 内 容 如 下 
schema fields [field class.index fieldname] = TEXT(stored=True, 
analyzer=ChineseAnalyzer () ,field boost=field class.boost,sortable= 
True) 


完成 settings.py 和 whoosh_cn_backend.py 的 配置 后 ， 接 下 来 实现 搜索 引擎 的 开发 。 
在 功能 开发 之 前 ， 需 要 在 项 目 应 用 index 的 models.py 中 重新 定义 数据 模型 Product， 
模型 Product 作为 搜索 引擎 的 搜索 对 象 。 模 型 Product 的 定义 代码 如 下 : 


from django.db import models 

# 创建 产品 信息 表 

class Product (models.Model): 
id = models.AutoField(' 序 号 ',， primary_key=True) 
name = models.CharField(' 名 称 ',max_length=50) 
weight = models.CharField(' 重量 ',max_ length=20) 
describe = models.CharField(' 描述 ',max_length=500) 
# 设置 返回 值 
def _str (self): 

return self.name 














将 定义 好 的 模型 Product 执行 数据 迁移 ， 在 数据 库 中 生成 数据 表 index_product， 
并 对 数据 表 index_product 导入 数据 内 容 ， 如 图 13-10 所 示 。 


文中 疾 壤 宣 看 D 。 帮助 
i 国 备 主 -本 刁 # 四 SA 革 Sd 
刘 name weight describe 
» 1 R10 1720 为 芝 给 V10 是 天 旭 并 下 一元 乔 各 手机 , 2017 年 11 月 28 昌 在 志 京 必 布 。 匡 下 V10 本 备 5.99 芝 二 18 : 9: 
2 HUAWEI nova zs 1699 
3 HRWaterplay 4659 
4 于 板 
5 PORSCHE DESIGN Porsche Desigr 生 本 (Porsche Lizenz- und Handelsgesellscha 人 ,部 部 位 于 车 国 的 gletigheim-Bil 
二 为 手 环 82 . 即 TakBand B2 . 旦 华为 公司 于 2015 年 4 月 推出 的 一 区 各 雍 竹 环 . 司 名 思 以 皇 TalkBant 
2016 生 6 月 16 过 发 布 芝 9V2A 到 癌 亿 元 格 动 电 尝 :条 革 帮 动 生 混 10000mAh。 坟 持 双向 亿 元 ， 
于 二 于 2017 年 6 月 12 日 在 上海 东 方 体育 中 心 正式 发 布 首 厅 筷 能 杀 导 所 一 关 直 杀人 际 。2017 年 6 月 18 
V9 的 旦 57 甘 的 2K 分 家 率 习 薪 ， 异 占 比 交 说 荣 泽 V9 要 更 上 优势 也 符合 大 家 对 于 在 边 
iphone X 必 于 计 湛 括 人 酝 ， 竹 用 全 新 设计 ， 搓 吉 税利 的 OLED 屏 奏 , 本 和 并 要 后 的 相 届 ,信用 3D| 


> 
mi1wme 回忆 
苞 1 条 记 录 ( 共 10 条 ) 于 笃 1 页 


13-10 数据 表 index_product 的 数据 信息 








现在 开始 讲述 搜索 引擎 的 开发 过 程 ， 首 先 创建 搜索 引擎 的 索引 。 创 建 索引 主要 能 
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使 搜索 引擎 快速 找到 符合 条 件 的 数据 ， 索 引 就 像 是 书本 的 目录 ， 可 以 为 读者 快速 地 查 
找 内 容 ， 在 这 里 也 是 同样 的 道理 。 当 数据 量 非常 大 的 时 候 ， 要 从 这 些 数据 中 找 出 所 有 
满足 搜索 条 件 的 数据 是 不 太 可 能 的 ， 并 且 会 给 服务 器 带 来 极 大 的 负担 ， 所 以 我 们 需要 
为 指定 的 数据 添加 一 个 索引 。 


索引 是 在 search_indexes.py 中 定义 的 ， 然 后 由 指令 执行 创建 过 程 。 我 们 以 模型 
Product 为 例 ， 在 search_indexes.py 中 定义 该 模型 的 索引 类 ， 代 码 如 下 : 


from haystack import indexes 
from .models import Product 
# 类 名 必须 为 模型 名 +Index， 比 如 模型 Product， 索 引 类 为 ProductIndex 
class ProductIndex (indexes.SearchIndex, indexes.Indexable): 
text = indexes.CharField(document=True, use template=True) 
# 设置 模型 
def get model (self): 
return Product 
# 设置 索引 的 创建 范围 
def index queryset (self, using=None): 
return self.get model() .objects.all() 


从 上 述 代 码 来 看 ， 在 定义 模型 的 索引 类 时 ， 类 定义 要 求 以 及 定义 说 明 如 下 : 

(1) 定义 索引 类 的 文件 名 必须 为 search_indexes.py， 不 得 修改 文件 名 ， 否 则 程序 
无 法 创建 索引 。 

(2) 索引 类 的 类 名 格式 必须 为 “模型 名 +mndex”， 每 个 模型 对 应 一 个 索引 类 ， 
如 模型 Product 的 索引 类 为 ProductIndex。 

(3) 字段 text 设置 document=True， 代 表 搜 索引 擎 将 使 用 此 字段 的 内 容 作为 索引 
进行 检索 。 

(4) use _ template=True 是 使 用 索引 模板 建立 索引 文件 ， 可 以 理解 为 在 索引 中 设 
置 模型 的 查询 字段 ， 如 设置 Product 的 describe 字段 ， 这 样 可 以 通过 describe 的 内 容 检 
索 Product 的 数据 。 

(5) 类 函数 get model 是 将 该 索引 类 与 模型 Product 进行 绑 定 ， 类 函数 index_ 
queryset 用 于 设置 索引 的 查询 范围 。 


从 上 述 分 析 可 以 知道 ，use_template=True 是 使 用 索引 模板 建立 索引 文件 ， 索 引 
模板 的 路 径 是 固定 的 ， 其 格式 为 /templates/search/indexes/ 项 目 应 用 的 名 称 / 模型 (小 
写 ) _text.txt。 以 ProductIndex 为 例 ， 其 索引 模板 路 径 为 templates/search/indexes/index/ 
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product texttxt。 我 们 在 索引 模板 中 设置 模型 Product 的 name 和 describe 字段 作为 索 
引 的 检索 字段 ， 可 以 在 索引 模板 中 添加 以 下 代码 : 





# templates/search/indexes/index/product text.txt 
{{ object.name }} 
{{ object.describe }} 


上 述 设 置 是 对 Productname 和 Product.describe 两 个 字段 建立 索引 ， 当 搜索 引擎 
进行 检索 时 ， 系 统 会 根据 搜索 条 件 对 这 两 个 字段 进行 全 文 检 索 匹 配 ， 然 后 将 匹配 结果 
排序 后 并 返回 。 

现在 只 定义 了 搜索 引擎 的 索引 类 和 索引 模板 , 我 们 可 以 根据 这 两 者 创建 索引 文件 ， 
通过 指令 python manage.py rebuild_index 即 可 完成 索引 文件 的 创建 ， 在 MyDjango 中 
可 以 看 到 whoosh index 文件 夹 ， 该 文件 夹 中 含有 索引 文件 ， 如 图 13-11 所 示 。 











互 

















MyDjango 
> Bindex 
> Bi MyDjango 
Y Bl whoosh index 
访 _MAIN_1toc 
访 MAIN_ti6g58t5t1zp3oaseg 
需 MAIN_WRITELOCK 
篇 manage.py 
plll External Ubraries 


图 13-11 索引 文件 





最 后 在 Django 中 实现 搜索 功能 ， 实 现 模 型 Product 的 全 文 检索 。 在 urls.py、 
Views.py 和 search.html 中 分 别 定义 搜索 引擎 的 URL 地 址 、URL 的 视图 以 及 HTML 模 
板 ， 具 体 的 代码 及 说 明 如 下 : 


# urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 
# 搜索 引擎 
path('search.html', views.MySearchView(), name='haystack'), 


] 


# views.py 

from django.shortcuts import render 

from django.core.paginator import Paginator, EmptyPage, PageNotAnIinteger 
from django.conf import settings 

from .models import * 
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from haystack.views import SearchView 
# 视图 以 通用 视图 实现 
class MySearchView (SearchView): 
# 模板 文件 
template = 'search.html"' 
# 重 写 响 应 方式 ， 如 果 请 求 参 数 q 为 室 ， 返 回 模型 Product 的 全 部 数据 ， 否 则 根据 参数 q 搜 
索 相关 数据 
def create response(self): 
if not self.request.GET.get('q', ''): 
show all = True 
product = Product.objects.all () 
paginator = Paginator (product, settings.HAYSTACK SEARCH_ 
RESULTS_ PER_ PAGE) 
try: 
page = paginator.page(int (self.request.GET.get ('page', 
1))) 
except PageNotAnInteger: 
# 若 参数 page 的 数据 类 型 不 是 整 型 ， 则 返回 第 一 页 的 数据 
page = paginator.page (1) 
except EmptyPage: 
# 若 用 户 访问 的 页 数 大 于 实际 页 数 ， 则 返回 最 后 一 页 的 数据 
page = paginator.page (Paginator.num pages) 
return render(self.request, self.template, locals()) 
el9es: 
show all = False 
qs = Super (MySearchView, self).create response() 
return qs 


# search.html 

# 由 于 search.html 代码 较 多 ， 此 处 只 列 出 关键 代码 

<ul class="songlist list"> 

{# 列 出 当前 分 页 所 对 应 的 数据 内 容 #} 

{% if show all %} 

{% for item in page.object list %} 

<1i class="js_songlist child" mid="1425301" ix="6"> 
<div class="songlist item"> 

songlist songname">{{ item.name }}</div> 

songlist artist">{{item.weight}}</div> 

<div class="songlist album">{{ item.describe }}</div> 

</div> 

天 /和 

{ endfor 要 } 

{% else $} 

{# 导入 自 带 高 亮 功 能 #} 

{% load highlight %} 

{g for item in page.object list %} 
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<1li class="js songlist child" mid="1425301" ix="6"> 
<div class="songlist item"> 
<div class="songlist songname">{% highlight item.object.name 
with query $}</div> 
<div class="songlist artist">{{item.object.weight} }</div> 
<div class="songlist album">{% highlight item.object.describe 
with query %}</div> 
</div> 
</1i> 
{% endfor $} 
{% endif %} 
</ul> 


上 述 代 码 中 ， 视 图 是 通过 继承 SearchView 类 实现 的 ， 父 类 SearchView 是 由 
Django Haystack 封装 的 视图 类 。 如 果 想 了 解 Django Haystack 封装 的 视图 类 ， 可 以 在 
Python 安装 目录 查看 具体 的 源 代 码 ， 文 件 路 径 为 \Lib\site-packages\haystack\views.py， 
也 可 以 查看 Django Haystack 官方 文档 。 

在 模板 文件 search.html 中 ， 我 们 将 搜索 结果 中 的 搜索 条 件 进行 高 亮 显示 。 模 板 
标签 highlight 是 Django Haystack 自 定义 的 标签 ， 标 签 的 使 用 方法 较为 简单 ， 此 处 不 
做 详细 介绍 ， 具 体 使 用 方法 可 以 参考 官方 文档 http://django-haystack .readthedocs.io/en/ 
master/templatetags.html。 

启动 MyDjango 项 目 ， 在 浏览 器 上 输入 http://127.0.0.1:8000/search.html， 并 在 右 
上 方 输入 “移动 电源 ”进行 搜索 ， 搜 索 结 果 如 图 13-12 所 示 。 














Daag 
< 了 Clolzroon 








图 13-12 搜索 结果 
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13.4 第 三 方 用 户 注册 


用 户 注册 与 登录 已 经 成 为 网 站 必 备 的 功能 之 一 ，Django 内 置 的 Auth 认证 系统 可 
以 帮助 开发 人 员 快 速 实现 用 户 管理 功能 。 但 很 多 网 站 为 了 加 强 社交 功能 ， 在 用 户 管理 
功能 上 增设 了 第 三 方 用 户 注册 与 登录 功能 , 这 是 通过 OAuth 2.0 认证 与 授权 来 实现 的 。 
OAuth 2.0 的 具体 实现 过 程 相对 人 烦琐， 我 们 通过 流程 图 来 大 致 了 解 OAuth 2.0 的 实现 过 


程 ， 如 图 13-13 所 示 。 


2 请 或 用 户 授权 一 一 一 2 


4 带 步骤 3 但 到 的 授 授 权 申 请 code 一 一 姑 | 





8 使 用 access token 申 请 用 户 信息 - 
图 13-13 OAuth 2.0 的 实现 过 程 


分 析 实 现 流 程 ， 我 们 可 以 简单 理解 OAuth 2.0 认证 与 授权 是 两 个 网 站 的 服务 器 后 
台 进 行 通信 交流 。 根 据 实现 原理 ， 可 以 使 用 requests 库 或 urllib 标准 库 实 现 OAuth 2.0 
认证 与 授权 ， 从 而 实现 第 三 方 用 户 的 注册 与 登录 功能 。 如 果 网 站 涉及 多 个 第 三 方 网 站 ， 
这 种 实现 方式 是 不 太 可 取 的 ， 而 且 发 现代 码 会 出 现 重复 使 用 的 情况 。 因 此 ， 我 们 可 以 
使 用 Django 第 三 方 功能 应 用 Django Social Auth， 它 为 我 们 提供 了 各 大 网 站 平台 的 认 
证 与 授权 功能 。 

Django Social Auth 是 在 Python Social Auth 的 基础 上 进行 封装 而 成 的 ， 除 了 安装 
Django Social Auth 之 外 ， 还 需要 安装 Python Social Auth。 通 过 pip 方式 进行 安装 ， 安 
装 指令 如 下 : 


pip install python-social-auth 
pip install social-auth-app-django 
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功能 模块 安装 成 功 后 ， 以 MyDjango 项 目 为 例 ， 讲 述 如 何在 Django 中 使 用 








Django Social Auth 实现 第 三 方 上 











MyDjango 的 目录 结构 较为 简单 ， 因 


~ Ba MyDjango 
忆 _jinit_py 
硬 settingspy 
局 urspy 
访 wsgipy 
v bluser 
> By migrations 
~ Datemplates 
曲 userhtml 
六 jinit_py 
亏 adminpy 
转 appspy 
局 modelspy 
蕊 tests.py 
务 unspy 
二 viewspy 
刻 manage.py 











图 13-14 MyDjango 的 目录 结构 








户 注 册 功 能 ，MyDijango 的 目录 结构 如 图 13-14 所 示 。 


为 Django Social Auth 的 本 质 是 一 个 Django 


的 项 目 应 用 。 可 以 在 Python 的 安装 目录 下 找到 Django Social Auth 所 有 的 源 代码 文件 ， 
发 现 它 具有 urlspy、views.py 和 models.py 等 文件 ， 这 与 Django App (项 目 应 用 ) 的 
文件 架构 是 一 样 的， 如 图 13-15 所 示 。 














这 台电 脑 本 地 区 各 E) ，Python ， lib ，site-packages ，sodal django 

Ba 作 改 昌明 [ 

国 _pyeache_ 2018/6/28 924 

Bmigrations 2018/6/28 9:24 

国 _ini_py 2018/6/28 923 。 Python File 
区 adminpy 2018/6/289:23 。 Python Fle 
B compatpy 208//28 923 。 Python file 
区 conf.py 2018/6/28 9:23 python File 
区 context processors.py 2018)6/28 23 。 python Fle 
Bfields.py 2018)6/28 9:23 Python Fle 
区 managerspy Python File 
B middleware py python Fle 
区 modelspy Python Fle 
区 storagepy Python Fle 
Bstrategypy pymon Fle 
屋 sdspy Python Fle 
Butilspy 201816/28923 。 python Fle 
屋 views.py 2018j6/28 923 Python Fle 


区 小 


1K8 
3 KB 
1 KB 
1 KB 
2 KB 
3 KB 
1 KB 
3 KB 
5 KB 
7KB 
GK8 
1K8 
KB 
6KB 








图 13-15 Django Social Auth 的 源 代 码 文件 


了 解 Django Social Auth 的 本 质 后 ， 在 后 续 的 使 用 中 可 以 更 加 清晰 地 知道 它 的 实 








现 过 程 。 本 节 以 微 博 账号 实现 上 
(http://open.weibo.com/) ， 登 录 微 博 


























户 的 注册 功能 。 首 先 在 浏览 器 中 打开 微 博 开放 平台 








新 建 应 用 ， 然 后 获取 应 | 











的 App Key 和 App 
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Secret， 如 图 13-16 所 示 。 





应 用 基本 信息 


应 用 关 型 :营运 应 用 ”- 网 页 应 用 


应 用 和 称 : MyDjango 


App Key 。 692671009 


App Secret :dzc4440e1a6d7950b1585cc53334a527 











图 13-16 获取 App Key 和 App Secret 









































下 一 步 是 设置 应 用 的 OAuth 2.0 授权 设置 , 单 击 应 用 中 的 高 级 信息 , 编 
授权 设置 的 授权 回调 页 ， 如 图 13-17 所 示 。 
EEE 
| oAuth2.0 sis 村 [cD 
国 tus mm Mp27 0 Leo00/ complete wet 
回 see | WA :http//127 00 1:8000/disconnect/weibo/ 
es | 安全 设 蔷 Cm 
加 wa 
国 得 款 信 斩 应 服务 1p 地 二 未 大 本 
图 13-17 OAuth2.0 授权 设置 
授权 回调 页 的 URL 地址 必须 为 /complete/weibo/， 因 为 授权 回调 页 是 




















OAuth 2.0 


由 Django 





Social Auth 进行 处 理 的 ， 而 它 已 经 为 授权 回调 页 设置 相应 的 地 址 路 径 。 可 以 打开 
Django Social Auth 的 源 代码 文件 urls.py 查看 具体 的 设置 内 容 ， 如 图 13-18 所 示 。 














URLs noddlen™™ 
rom django.conf import seccings 
ron django .ccnt .arla import zl 


rom social_core.utils lmport setting nane 
ron . inport vievs 











图 13-18 源 代码 文件 urls.py 
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完成 上 述 配 置 后 ， 接 着 在 settingspy 中 设置 Django Social Auth 的 配置 信息 ， 主 要 
在 INSTALLED APPS 和 TEMPLATES 中 引入 功能 模块 以 及 设置 相关 的 功能 配置 ， 配 
置信 息 如 下 : 


INSTALLED APPS = [ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
"django .contrib.sessions'v 
"django .contrib.messages'v 
"django .contrib.staticfiles'yv 
"user'v 
# 添加 第 三 方 应 用 


"social_ django' 


# 设置 第 三 方 的 OAuth 2.0， 所 有 第 三 方 的 oauth 2.0 可 以 查看 源码 目录 : \Lib\site- 
packages\social\backends 
AUTHENTICATION BACKENDS = ( 


'social.backends.weibo.WeiboOoAuth2', # 微 博 的 功能 
"social.backends .qq.QQORuth2' # QQ 的 功能 
'social.backends.weixin.WeixinOoAuth2', # 微 信 的 功能 


"django .contrib.auth.backends .ModelBackend',) 
# 注册 成 功 后 跳 转 页 面 
SOCIAL RUTH LOGIN REDIRECT URL = 'success' 
# 开放 平台 应 用 的 APPID 和 SECRET 
SOCIAL AUTH WEIBO KEY = '692671009' 
SOCIAL AUTH WEIBO SECRET = 'd2c4440ela6d7950b1585cc58334a527"' 
SOCIAL AUTH QQ KEY = 'APPID' 
SOCIAL AUTH QQ SECRET = 'SECRET" 
SOCIAL AUTH WEIXIN KEY = 'APPID' 
SOCIAL AUTH WEIXIN SECRET = 'SECRET' 


TEMPLATES = [ 
{ 


'OPTIONS': { 


'context processors': [ 


# 需要 添加 的 配置 信息 
"social django.context processors.backends', 
'social django.context processors.login redirect', 
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] 


因为 Django Social Auth 定义 了 相关 的 数据 模型 ， 完 成 settings.py 的 配置 后 ， 需 要 
使 用 python manage.py migrate 执行 数据 迁移 ， 生 成 相关 的 数据 表 。 最 后 在 MyDjango 
项 目 中 实现 第 三 方 用 户 注册 功能 ， 功 能 主要 由 MyDjango 的 urls.py、 项 目 应 用 user 的 
urlspy、views.py 和 userhtml 共同 实现 ， 分 别 编写 相关 的 功能 代码 ， 代 码 如 下 : 


# MyDjango 的 urls.py 
from django .contrib import admin 
from django.urls import path, include 
from django.conf.urls import url 
urlpatterns = [ 
path('admin/', admin.site.urls), 
path('', include('user.urls')), 
# 导入 social_django 的 URL， 源 码 地 址 为 \Lib\site-packages\social django\ 
urls.py 
url('', include('social django.urls', namespace='social')) 


] 


# 项 目 应 用 user 的 urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 

# 用 户 注册 界面 的 URL 地 址 ， 显 示 微 博 登录 链接 
path('', views.loginView, name='login’'), 

# 注册 后 回调 的 页 面 ， 成 功 注册 后 跳 转 回 站 内 地 址 
path('success', views.success, name='success') 


] 


# views.py 
from django.shortcuts import render 
# 用 户 注册 界面 
def loginView (request): 
title = ' 用 户 注册 ，' 
return render (Tequest， '‘'user.html', locals()) 
# 注册 后 回调 的 页 面 


from django.http import HttpResponse 





def success (request): 
return HttpResponse(' 注册 成 功 ') 


# user.html 


<!DOCTYPE html> 
<html lang="zh-cn"> 
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<head> 
<meta charset="utf-8"> 
<title>{{ title }}</title> 
<link rel="stylesheet" href="https://unpkg.com/mobi.css/dist/mobi. 
min.css"> 
</head> 
<body> 
<div class="flex-center"> 
<div class="container"> 
<div class="flex-center"> 
<div class="unit-1-2 unit-l-on-mobile"> 
<hl>MyDjango Social Auth</hl> 
<div> 
# {% url "social:begin" "weibo" %} 来 自 Lib\site-packages\social_ 
django\urls.py 
<a class="btn btn-primary btn-block" href="{% url "social:begin" 
"weibo" $%}"> 微 博 注册 </a> 
</div> 
</div> 
</div> 
</div> 
</div> 
</body> 
</html> 


在 上 述 代 码 中 ， 我 们 一 共 设 置 了 三 个 URL 路 由 地 址 ， 分 别 为 social、login 和 
success， 三 者 的 作用 说 明 如 下 。 


(1) social: 导入 Django Social Auth 的 URL， 将 其 添加 到 MyDjango 项 目 中 ， 
主要 生成 授权 页 面 和 处 理 授权 回调 请 求 。 


(2) login: 生成 网 站 的 用 户 注 册页 面 ， 为 授权 页 面 提供 链接 入 口 ， 方 便 用 户 进 
入 授权 页 面 。 


(3) success: 授权 回调 处 理 完 成 后 ， 程 序 自动 跳 转 的 页 面 ， 由 settings.py 的 配 
置 属 性 SOC IAL AUTH LOGIN REDIRECT URL 设置 。 


启动 MyDjango 项 目 ， 在 浏览 器 中 输入 http://127.0.0.1:8000/ 并 单 击 微 博 “注册 ” 
按钮 ， 网 页 会 出 现 微 博 的 授权 认证 页 面 ， 然 后 单 击 “ 授 权 ” 按 钮 ， 程 序 会 自动 跳 转 到 
success 的 URL 所 生成 的 页 面 ， 如 图 13-19 所 示 。 
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MyDjango Social Auth 

















完成 微 博 的 认证 与 授权 后 ， 我 们 在 数据 库 中 分 别 
usersocialauth 和 auth_user。 可 以 发 现 两 个 数据 表 都 创建 了 
证 授权 后 的 微 博 用 户 信息 ， 后 者 是 根据 前 者 的 用 户 信息 在 网 站 中 创建 的 


13-20 所 示 。 


图 13-19 微 博 授权 认证 过 程 
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图 13-20 数据 表 social_auth_usersocialauth 和 auth_user 











用 户 ， 如 


查看 数据 表 social auth_ 
用 户 信息 ， 前 者 是 微 博 认 


图 





上 述 例子 主要 实现 了 第 三 方 用 户 注册 网 站 账号 的 功能 。 除 此 之 外 ， 还 可 以 实现 第 


三 方 用 户 登录 网 站 、 第 三 方 | 























户 关联 已 有 的 网 站 账号 以 及 Admin 后 台 管理 设置 等 功能 。 


由 于 篇 幅 有 限 就 不 再 详细 讲述 ， 有 兴趣 的 读者 可 以 参考 官方 文档 (http://python-social- 
auth.readthedocs.io/en/latest/) 和 查阅 相关 资料 。 


13.5 分 布 式 任务 与 定时 任务 





网 站 的 并 发 编程 主要 处 理 网 站 的 业务 流程 ， 根 据 网 站 请 求 到 响应 的 过 程 分 析 ， 








Django 处 理 用 
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户 请 求 主要 在 视图 中 执行 ， 视 图 主要 是 一 个 函数 ， 而 且 是 单线 程 执 行 的 
函数 。 在 视图 函数 处 理 用户 请 求 时 ， 如 果 遇 到 烦琐 的 数据 读 写 或 高 密度 计算 ， 往 往 会 
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造成 响应 时 间 过 长 ， 在 网 页 上 容易 出 现 卡 死 的 情况 ， 不 利于 用 户 体验 。 为 了 解决 这 种 
情况 ， 我 们 可 以 在 视图 中 加 入 分 布 式 任务 ， 让 它 处 理 一 些 耗 时 的 业务 流程 ， 从 而 缩短 
用 户 响应 时 间 。 

Django 的 分 布 式 主要 由 Celery 框架 实现 ， 这 是 Python 开发 的 分 布 式 任务 队列 。 
它 支 持 使 用 任务 队列 的 方式 在 分 布 的 机 器 、 进 程 和 线程 上 执行 任务 调度 。Celery 侧 习 
于 实时 操作 ， 用 于 生产 系统 每 天 处 理 数 以 百 万 计 的 任务 。Celery 本 身 不 提供 消息 存储 
服务 , 它 使 用 第 三 方 消息 服务 来 传递 任务 。 目 前 支持 RabbitMQ、Redis 和 MongoDB 等 。 

本 节 使 用 第 三 方 应 用 Django Celery Results、Django Celery Beat、Celery 和 Redis 
数据 库 实现 Django 的 分 布 式 任务 和 定时 任务 开发 。 值 得 注意 的 是 ， 定 时 任务 是 分 布 
式 任务 的 一 种 特殊 类 型 任务 。 

首先 需要 安装 Redis 数据 库 ， 在 Windows 中 安装 Redis 数据 库 有 两 种 方式 ， 在 官 
网 下 载 压 缩 包 安装 和 在 GitHub 下 载 MSI 安装 程序 。 前 者 的 数据 库 版 本 是 最 新 的 ， 但 
需要 通过 指令 安装 并 设置 相关 的 环境 配置 ， 后 者 是 旧版 本 ， 但 安装 方法 是 傻瓜 式 安装 ， 
启动 程序 后 单 击 按钮 即 可 完成 安装 。 两 者 的 下 载 地 址 如 下 : 
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# 官网 下 载 地 址 

https://redis.io/download 

# github 下 载 地 址 

https://github.com/MicrosoftArchive/redis/releases 

Redis 数据 库 的 安装 过 程 本 书 就 不 详细 讲述 了 ， 读 者 可 以 自行 查阅 相关 的 资料 。 
除了 安装 Redis 数据 库 之 外 ， 还 可 以 安装 Redis 数据 库 的 可 视 化 工具 ， 可 视 化 工具 可 
以 帮助 初次 接触 Redis 的 读者 了 解数 据 库 结构 。 本 书 使 用 Redis Desktop Manager 作为 
Redis 的 可 视 化 工具 ， 如 图 13-21 所 示 。 
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图 13-21 Redis Desktop Manager 
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下 一 步 是 安装 本 节 所 需要 的 功能 模块 ， 主 要 的 功能 模块 有 : celery、redis、 
django-celery-results、django-celery-beat 和 eventlet。 这 些 功能 模块 能 通过 pip 完成 安装 ， 
安装 指令 如 下 : 

pip install celery 

pip install redis 

pip install django-celery-results 

pip install django-celery-beat 

pip install eventlet 

每 个 功能 模块 负责 实现 不 同 的 功能 ， 在 此 简单 讲解 各 个 功能 模块 的 具体 作用 ， 其 
说 明 如 下 。 

















(1) celery: 安装 Celery 框架 ， 实 现 分 布 式 任务 调度 。 

(2) redis: 使 Python 与 Redis 数据 库 实现 连接 。 

(3) django-celery-results: 基于 Celery 基础 上 封装 的 分 布 式 任务 功能 ， 主 要 适用 
于 Django。 

(4) django-celery-beat: 基于 Celery 基础 上 封装 的 定时 任务 功能 ， 主 要 适用 于 
Django。 

(5) eventlet: Python 的 协 程 并 发 库 ， 这 是 Celery 实现 分 布 式 的 并 发 模式 之 一 。 














在 MyDjango 项 目 中 ， 分 别 在 MyDijango 文件 夹 创建 celerypy 和 在 项 目 应 用 index 
中 创建 tasks.py。 前 者 是 在 Django 框架 中 引入 Celery 框架 ， 后 者 是 创建 MyDjango 的 
分 布 式 任务 。MyDJango 的 目录 结构 如 图 13-22 所 示 。 

















图 13-22 MyDjango 的 目录 结构 
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然后 在 celerypy 和 tasks.py 文件 中 分 别 编写 功能 代码 。celery.py 的 代码 基本 是 固 
定 的 ， 而 tasks.py 的 代码 可 以 根据 需求 自行 编写 。 两 者 代码 如 下 : 


# celery.py 文件 
from future ”import absolute import, unicode literals 
import os 
from celery import Celery 
# 获取 settings .py 的 配置 信息 
os.environ.setdefault ('DJANGO SETTINGS MODULE', "MyDjango.settings') 
# 定义 Celery 对 象 ， 并 将 项 目 配置 信息 加 载 到 对 象 中 。 
# Celery 的 参数 一 般 以 为 项 目 名 命名 
app = Celery('MyDjango') 
app.config from object('django.conf:settings', namespace='CELERY') 
app.autodiscover tasks() 
# 创建 测试 任务 
Q@app.task (bind=True) 
def debug task(self) : 
print('Request: {0!r}'.format (self.request)) 


# tasks.py 文件 
from celery import shared task 
from .models import * 
import time 
# 带 参数 的 分 布 式 任务 
@shared _ task 
def updateData (Product_id，value) : 
Product .objects.filter (id=product_id) .update (weight=value) 


# 该 任务 用 于 执行 定时 任务 
@shared task 
def timing(): 
now = time.strftime ("%H:%M:%S") 
with open("E:\\output.txt", "a") as f: 
f.write("The time is " + now) 
f.write("\n") 
f.close() 


从 celery.py 的 代码 得 知 ， 该 文件 是 将 Celery 框架 进行 实例 化 并 生成 app 对象。 
现在 还 需要 将 app 对 象 与 MyDjango 项 目 进行 连接 ， 使 项 目 可 以 执行 分 布 式 任务 。 在 
celerypy 同一 级 目录 的 _init _.py 中 编写 相关 代码 ， 当 MyDjango 初始 化 时 ，Django 
会 自动 加 载 app 对 象 。 init _.py 的 代码 如 下 : 

from future _ import absolute import, unicode literals 


from .celery import app as celery app 
_all = ['celery app'] 
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再 分 析 tasks.py 中 的 函数 updateData 可 知 , 该 函数 是 对 模型 Product 进行 读 写 操作 。 














因此 ， 我 们 需要 在 models.py 中 定义 模型 Product， 然 后 对 模型 Product 执行 数据 迁移 ， 





并 在 对 应 的 数据 表 中 导入 相关 的 数据 内 容 。 模 型 Product 的 定义 如 下 : 


并 且 


from django .db import models 

# 创建 产品 信息 表 

class Product (models.Model): 
id = models.AutoField(' 序 号 ', primary key=True) 
name = models.CharField(' 名 称 ',max_ length=50) 
weight = models.CharField(' 重量 ',max length=20) 
describe = models.CharField(' 描述 ' max_ length=500) 
# 设置 返回 值 
def _str (self): 

return self.name 


将 定义 好 的 模型 Product 执行 数据 迁移 ， 在 数据 库 中 生成 数据 表 index_product， 


对 数据 表 导 入 相关 数据 内 容 ， 数 据 表 index_product 的 数据 信息 如 图 13-23 所 示 。 
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13-23 数据 表 index_product 的 数据 信息 
接着 在 MyDjango 的 settings.py 中 配置 Celery 的 配置 信息 ， 由 于 本 节 需 要 实现 分 














布 式 任务 和 定时 任务 ， 因 此 配置 信息 主要 对 两 者 进行 配置 ， 具体 的 配置 内 容 如 下 : 
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INSTALLED APPS = [ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.statictfiles', 
rindex', 

# 添加 分 布 式 任务 功能 
'django celery results', 
# 添加 定时 任务 功能 


'django celery beat' 
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] 


# 设置 存储 Celery 任务 队列 的 Redis 数据 库 


CELERY BROKER URL = 'redis://localhost:6379/0" 
CELERY ACCEPT CONTENT = ['json'] 
CELERY TASK SERIALIZER = "json' 


# 设置 存储 Celery 任务 结果 的 数据 库 
CELERY RESULT BACKEND = "django-db' 


# 设置 定时 任务 相关 配置 
CELERY ENABLE UTC = False 
CELERY BEAT SCHEDULER = "django celery beat.schedulers:Databasescheduler'"' 


配置 完成 后 ， 需 要 再 次 执行 数据 迁移 ， 因 为 分 布 式 任务 和 定时 任务 在 运行 过 程 中 





et a 完成 数据 迁移 后 ， 打 开 项 目的 数据 库 ， 可 以 看 到 


项 目 


一 共生 成 了 17 个 数据 表 ， 如 图 13-24 所 示 。 











index_product 


13-24 MyDjango 的 数据 库 结构 











最 后 在 项 目 应 用 index 的 urls.py 和 views.py 中 分 别 编写 URL 路 由 地 址 和 视图 函数 ， 

















户 访问 网 页 时 , MyDjango 将 自动 执行 分 布 式 任务 。urls.py 和 views.py 的 代码 如 下 : 


# urls.py 
from django.urls import path 
from . import views 
urlpatterns = [ 

# 首页 的 URL 

path('', views.index), 


] 


# views.py 

from django.http import HttpResponse 
from .tasks import updateData 

def index(request): 
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# 传递 参数 并 执行 异步 任务 
updateData.delay(10, '140g"' 
return HttpResponse ("Hello 





) 
Celery") 











至 此 ， 我 们 已 完成 Django 分 布 式 功能 的 代码 开发 ， 接 下 来 讲述 如 何 使 用 分 布 式 


任务 和 定时 任务 。 首 先 启动 MyDjango 
以 下 指令 启动 Celery: 











# 指令 中 的 MyDjango 是 项 目 名 


celery -A MyDjango worker -1 in 

















项 目 ， 然 后 单 击 PyCharm 的 Terminal， 并 输入 








Eo. =P eventlet 








Celery 成 功 启动 后 ，Celery 会 自动 加 载 MyDjango 定义 的 分 布 式 任务 ， 并 且 显 示 
相关 的 数据 库 连 接 信息 ， 如 图 13-25 所 示 。 























13-25 


Celery 启动 信息 


在 浏览 器 上 输入 http:/127.0.0.1:8000/， 视 图 函数 index 将 会 执行 分 布 式 任务 
updateData， 该 任务 是 在 数据 表 index_product 卡 找到 ID=10 的 数据 ， 然 后 将 该 数据 的 
字段 weight 内 容 改 为 140g。 当 分 布 式 任务 执行 成 功 后 ， 执 行 的 结果 会 显示 在 Terminal 








中 ， 并 以 及 保存 到 数据 表 django_celery_results_taskresult 中 ， 如 图 13-26 所 示 。 
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图 13-26 分 布 式 任务 执行 结果 
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下 一 步 是 使 用 定时 任务 ， 定 时 任务 主要 通过 Admin 后 台 生 成 。 首 先 在 MyDjango 
中 创建 超级 用 户 root 并 登录 到 Admin 后 台 , 然后 进入 Periodic tasks 并 且 创 建 定 时 任务 ， 
将 任务 设置 为 每 间隔 3 秒 执行 函数 timing， 如 图 13-27 所 示 。 









































图 13-27 设置 定时 任务 
任务 设置 完毕 后 ， 我 们 通过 输入 指令 来 启动 定时 任务 。 在 输入 指令 之 前 ， 必 须 保 


证 MyDjango 和 Celery 处 于 运行 状态 。 简 单 来 说 , 如 果 使 用 CMD 模式 来 启动 定时 任务 ， 
需要 启动 三 个 CMD 窗口 ， 依 次 输入 以 下 指令 : 








# 启动 MYDjango 

Python manage.py runserver 8000 

# 启动 celery 

celery -A MyDjango worker -1 info -P eventlet 
# 启动 定时 任务 

celery -A MyDjango beat -1 info -Ss django 


如 果 在 PyCharm 中 启动 定时 任务 ， 可 以 在 Terminal 下 新 建 会 话 窗口 ， 输 入 相 


应 的 指令 即 可 。 定 时 任务 启动 后 ， 每 隔 三 秒 会 执行 一 次 程序 ， 在 Terminal 和 数据 表 
django_celery_results_taskresult 中 都 可 以 查看 相关 的 执行 情况 ， 如 图 13-28 所 示 。 














图 13-28 定时 任务 执行 情况 
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13.6 本 章 小 结 





本 章 主要 讲述 了 Django 的 第 三 方 功能 应 用 , 将 网 站 中 常用 的 功能 进行 封装 处 理 ， 
避免 开发 人 员 重 复 造 轮子 ， 缩 减 开发 时 间 以 及 维护 成 本 。 在 本 章 讲述 的 第 三 方 功 能 应 
用 的 实现 过 程 中 ， 我 们 可 以 总 结 出 大 致 的 实现 过 程 : 

在 settings.py 的 INSTALLED_APPS 中 添加 应 用 功能 以 及 设置 该 功能 的 相关 配置 。 

创建 新 的 .py 文件 ， 主 要 对 功能 进行 实例 化 或 定义 相关 的 对 象 ， 如 Django Rest 
Framework 的 serializers.py 和 搜索 引擎 的 search_indexes.py 等 。 

设置 项 目的 URL 地 址 以 及 调用 第 三 方 功能 内 置 的 URL 地 址 ， 如 Django Social 
Auth 和 Django Simple Captcha 等 。 

在 项 目的 视图 函数 中 ， 调 用 第 三 方 功能 的 对 象 或 实例 化 对 象 ， 使 其 作用 于 模型 或 
模板 ， 在 网 站 中 生成 相应 的 功能 界面 。 

最 后 读者 可 以 根据 本 章 讲述 的 内 容重 新 完善 第 11 章 的 网 站 功能 ， 如 完善 音乐 网 
站 的 搜索 功能 、 为 用 户 注 册 与 登录 添加 验证 码 以 及 新 增 第 三 方 用 户 注册 与 登录 等 。 
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